蝉镜 MCP Server

概述

蝉镜 MCP Server 是融合 LLM Agent 能力与公司 OpenAPI 平台的智能开发工具，提供视频生成、语音合成、数字人交互等场景的快速接入能力，支持通过标准化接口实现复杂多媒体内容的自动化生产。

场景介绍

传统 API 调用

若需按定制形象合成美妆相关视频，需要：

使用 APP_ID 和 APP_SECRET 手动调用认证接口获取 AccessToken
根据数字人需求调用定制数字人服务，生成数字人和声音，获取数字人 ID 和声音 ID
将上述 ID 及视频合成参数作为入参，调用合成视频 API 生成最终视频

整个过程需多次手动调用 API，耗时长，且要求开发者熟悉接口调用流程。

LLM Agent 方式

用户只需与 LLM Agent 对话并描述视频需求即可：

MCP 已预先在配置中写入 APP_ID 和 APP_SECRET，无需手动获取 AccessToken
MCP 会根据需求自动调用相应 API，并可按需微调，最终调用合成视频接口生成视频
全程无需手动干预，通过自然语言与 Agent 对话即可，大幅简化流程、提高效率

核心功能列表

分类	工具	说明
公共方法	get_access_token	获取 API 调用凭证
	get_user_info	获取用户账户信息
	get_user_duration	获取用户蝉豆信息
	font_list	获取可用字体列表
视频合成相关	create_video	创建合成视频任务
	delete_video	删除合成视频
	video	获取合成视频详情
	video_list	获取合成视频列表
语音合成相关	create_audio_task	创建合成音频任务
	get_audio_task_state	获取合成音频任务状态
定制数字人相关	list_common_dp	获取公共数字人列表
	create_customised_person	创建定制数字人
	delete_customised_person	删除定制数字人
	customised_person	获取定制数字人
	list_customised_person	获取定制数字人列表
定制声音相关	list_common_audio	获取公共声音列表
	create_customised_audio	创建定制声音
	delete_customised_audio	删除定制声音
	get_customised_audio	获取定制声音详情
	list_customised_audio	获取定制声音列表
文件管理	create_upload_url	获取 OSS 上传地址
	get_file_list	获取文件列表
	delete_file	删除文件

快速开始

在蝉镜 AI 开放平台获取 APP_ID 和 APP_SECRET
选择一种调用方式：SSE（远程） 或 Stdio（本地）

SSE 调用方式

通过远程 SSE 服务调用，无需下载本地程序，配置后即可使用。

Cursor

Cursor > Preferences > Cursor Settings > MCP > Add new global MCP Server 中添加：

json

{
  "mcpServers": {
    "chanjing": {
      "url": "https://mcp-service.chanjing.cc/sse?appId=填写你的开放接口ID&appSecret=填写你的开放接口密钥",
      "name": "蝉镜"
    }
  }
}

通义灵码

通义灵码 > MCP工具 > MCP服务 > 通过配置文件添加新增MCP服务 > lingma_mcp.json 中添加：

json

{
  "mcpServers": {
    "chanjing": {
      "url": "https://mcp-service.chanjing.cc/sse?appId=填写你的开放接口ID&appSecret=填写你的开放接口密钥",
      "name": "蝉镜"
    }
  }
}

Windsurf

Windsurf > Settings > Cascade > Add Server > Add custom server 中添加：

json

{
  "mcpServers": {
    "chanjing": {
      "serverUrl": "https://mcp-service.chanjing.cc/sse?appId=填写你的开放接口ID&appSecret=填写你的开放接口密钥",
      "name": "蝉镜"
    }
  }
}

Stdio 调用方式

本地运行 MCP 服务，适合需要完全本地控制的场景。

下载蝉镜 MCP 服务文件并保存到本地：
在本地新建用于存放 access_token.json 的目录

Cursor

在 Cursor > Preferences > Cursor Settings > MCP > Add new global MCP Server 中添加：

json

{
  "mcpServers": {
    "chanjing-api-mcp": {
      "command": "填写你的MCP服务文件的保存路径，例如：../mcp/chanjing-api-mcp",
      "env": {
        "APP_ID": "填写你的开放接口ID",
        "APP_SECRET": "填写你的开放接口密钥",
        "SOURCE_DIR": "access_token.json的文件存放路径，需要手动创建本地文件夹"
      },
      "name": "蝉镜"
    }
  }
}

通义灵码

在 通义灵码 > MCP工具 > MCP服务 > 通过配置文件添加新增MCP服务 > lingma_mcp.json 中添加：

json

{
  "mcpServers": {
    "chanjing-api-mcp": {
      "command": "填写你的MCP服务文件的保存路径，例如：../mcp/chanjing-api-mcp",
      "env": {
        "APP_ID": "填写你的开放接口ID",
        "APP_SECRET": "填写你的开放接口密钥",
        "SOURCE_DIR": "access_token.json的文件存放路径，需要手动创建本地文件夹"
      },
      "name": "蝉镜"
    }
  }
}

Windsurf

在 Windsurf > Settings > Cascade > Add Server > Add custom server > mcp_config.json 中添加：

json

{
  "mcpServers": {
    "chanjing-api-mcp": {
      "command": "填写你的MCP服务文件的保存路径，例如：../mcp/chanjing-api-mcp",
      "env": {
        "APP_ID": "填写你的开放接口ID",
        "APP_SECRET": "填写你的开放接口密钥",
        "SOURCE_DIR": "access_token.json的文件存放路径，需要手动创建本地文件夹"
      },
      "name": "蝉镜"
    }
  }
}

完成上述配置后，即可在 Cursor、通义灵码、Windsurf 等客户端中通过蝉镜 MCP 与蝉镜 API 交互。

使用示例（Windsurf + Stdio）

1. 配置 MCP 服务

添加 MCP Server

配置 JSON 文件

刷新并确认 MCP Server 状态

若出现 MCP 文件无法读取等问题，请检查：

mcp_config.json 中 command 路径是否与 MCP 可执行文件路径一致
MCP 服务文件是否有可读与可执行权限

更多说明见 Tips。

2. 使用 Agent 口述需求生成视频

建议使用 gpt-4o 模型。

一句话描述视频需求

选择数字人并继续生成

任务自动提交

查询视频制作进度

Tips

一、macOS 权限问题

若因权限导致无法读写 MCP 服务文件，可先修正权限：

在终端执行（将路径替换为你的 MCP 可执行文件路径）：

bash

sudo chmod 777 /所下载MCP服务文件的完整路径

若出现 Apple 安全拦截，请在 系统设置 > 隐私与安全性 > 安全性 中对该 MCP 文件选择「仍要打开」，然后刷新 MCP Servers 并执行「仍然打开」完成部署。

二、access_token 无效

确认是否在其他地方调用了 GetAccessToken，导致当前 token 被顶掉失效。
重新刷新 MCP Server 状态，并新建一个 Agent 对话窗口再试（刷新 MCP 会重新拉取 token，旧 token 会失效）。

三、各平台 Auto-Run / Auto-Fix 建议

建议在各平台开启 Auto-Run、Auto-Fix，便于自动运行与自动修复参数错误。

Cursor

通义灵码

Windsurf

Q&A

Q1：合成视频时 Agent 报 Call Tool 失败或合成服务不可用？

A1：根据 Agent 调用服务时的请求与返回参数排查是否为参数错误，例如：使用公共数字人需传 figure_type，音量参数需大于 0 等。可根据返回错误信息让模型修正参数后重试。

蝉镜 MCP Server ​

概述 ​

场景介绍 ​

传统 API 调用 ​

LLM Agent 方式 ​

核心功能列表 ​

快速开始 ​

SSE 调用方式 ​

Cursor ​

通义灵码 ​

Windsurf ​

Stdio 调用方式 ​

Cursor ​

通义灵码 ​

Windsurf ​

使用示例（Windsurf + Stdio） ​

1. 配置 MCP 服务 ​

2. 使用 Agent 口述需求生成视频 ​

Tips ​

一、macOS 权限问题 ​

二、access_token 无效 ​

三、各平台 Auto-Run / Auto-Fix 建议 ​

Q&A ​

蝉镜 MCP Server

概述

场景介绍

传统 API 调用

LLM Agent 方式

核心功能列表

快速开始

SSE 调用方式

Cursor

通义灵码

Windsurf

Stdio 调用方式

Cursor

通义灵码

Windsurf

使用示例（Windsurf + Stdio）

1. 配置 MCP 服务

2. 使用 Agent 口述需求生成视频

Tips

一、macOS 权限问题

二、access_token 无效

三、各平台 Auto-Run / Auto-Fix 建议

Q&A