蝉镜 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	刷新并检查当前会话凭证状态，不返回真实 token
	get_user_info	获取用户账户信息
	get_user_duration	获取用户蝉豆信息
	font_list	获取可用字体列表
	price_catalog	获取公开价格目录
	tag_list	获取公共数字人与声音标签字典
	consume_detail	获取蝉豆消耗明细
视频合成	create_video	创建合成视频任务
	video	获取合成视频详情
	video_list	获取合成视频列表
	delete_video	删除合成视频
语音合成	create_audio_task	创建合成音频任务
	create_audio_task_v2	创建合成音频任务 V2
	get_audio_task_state	获取合成音频任务状态
定制数字人	list_common_dp	获取公共数字人列表
	customised_person	获取定制数字人详情
	list_customised_person	获取定制数字人列表
	create_customised_person	创建定制数字人
	create_customised_person_v2	创建包含授权检测的定制数字人
	delete_customised_person	删除定制数字人
定制声音	list_common_audio	获取公共声音列表
	get_customised_audio	获取定制声音详情
	list_customised_audio	获取定制声音列表
	create_customised_audio	创建定制声音
	delete_customised_audio	删除定制声音
文件管理	create_upload_url	获取 OSS 预签名上传地址
	create_multipart_upload	创建文件分片上传任务
	complete_multipart_upload	完成文件分片上传任务
	file_list	获取文件列表
	file_detail	获取文件详情
	delete_file	删除文件
视频翻译与口型	video_translation_target_languages	获取视频翻译支持的目标语言
	video_translation_create	创建视频翻译任务
	lip_sync_create	创建对口型视频任务
	lip_sync_list	获取对口型视频列表
	lip_sync_detail	获取对口型视频详情
AIGC 创作	aigc_create_photo	创建文生图任务
	aigc_photo_task_page	分页查询文生图任务
	aigc_photo_task	查询文生图任务详情
	aigc_create_motion	创建图生视频任务
	aigc_motion_task_page	分页查询图生视频任务
	aigc_motion_task	查询图生视频任务详情
	ai_creation_submit	提交 AI 创作图片或视频任务
	ai_creation_page	分页查询 AI 创作任务
	ai_creation_task	查询 AI 创作任务详情
创意雷达	creative_briefing	生成创意雷达品类 Briefing

快速开始

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

SSE 调用方式

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

Codex

Codex > 设置 > 插件 > MCP > Add MCP Server 中添加：

json

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

WorkBuddy

专家.技能.连接器 > 连接器 > 自定义链接器 > 配置MCP > mcp.json 中添加：

json

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

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": "蝉镜"
    }
  }
}

Streamable HTTP 调用方式

Streamable HTTP 是标准 MCP 远程传输方式。客户端需支持为远程 MCP 服务配置自定义 HTTP Header；不支持时请使用 SSE 调用方式或 Stdio。

服务地址为 https://mcp-service.chanjing.cc/mcp。在客户端的 MCP 配置中填写服务地址和以下 Header：

json

{
  "mcpServers": {
    "chanjing": {
      "url": "https://mcp-service.chanjing.cc/mcp",
      "headers": {
        "X-Chanjing-App-Id": "填写你的开放接口ID",
        "X-Chanjing-App-Secret": "填写你的开放接口密钥"
      },
      "name": "蝉镜"
    }
  }
}

客户端会使用 POST /mcp 发送 MCP 请求，并可通过 GET /mcp 接收 SSE 事件、通过 DELETE /mcp 结束会话。除 OPTIONS 外，每个请求都必须携带上述两个鉴权 Header；请勿将凭证放在 URL 查询参数中。

首次 initialize 响应会返回 Mcp-Session-Id。MCP 客户端应在后续请求中原样携带该 Header；多实例部署时，网关必须按该 Header 进行会话粘性路由。请始终使用 HTTPS，并避免在日志或截图中暴露密钥。

Stdio 调用方式

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

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

Codex

在 Codex > 设置 > 插件 > MCP > Add 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": "蝉镜"
    }
  }
}

WorkBuddy

专家.技能.连接器 > 连接器 > 自定义链接器 > 配置MCP > 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": "蝉镜"
    }
  }
}

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": "蝉镜"
    }
  }
}

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

使用示例

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

Q&A

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

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

蝉镜 MCP Server ​

概述 ​

场景介绍 ​

传统 API 调用 ​

LLM Agent 方式 ​

核心功能列表 ​

快速开始 ​

SSE 调用方式 ​

Codex ​

WorkBuddy ​

Cursor ​

Streamable HTTP 调用方式 ​

Stdio 调用方式 ​

Codex ​

WorkBuddy ​

Cursor ​

使用示例 ​

1. 配置 MCP 服务 ​

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

Tips ​

一、macOS 权限问题 ​

二、access_token 无效 ​

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

Q&A ​

蝉镜 MCP Server

概述

场景介绍

传统 API 调用

LLM Agent 方式

核心功能列表

快速开始

SSE 调用方式

Codex

WorkBuddy

Cursor

Streamable HTTP 调用方式

Stdio 调用方式

Codex

WorkBuddy

Cursor

使用示例

1. 配置 MCP 服务

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

Tips

一、macOS 权限问题

二、access_token 无效

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

Q&A