蝉镜 MCP Server

概述

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

场景介绍

传统 API 调用

如果用户需要按照定制的形象来合成一个美妆相关的视频，那么用户首先需要通过 APP_ID 和 APP_SECRET 手动调用认证接口获取 AccessToken。接着需要根据数字人需求，调用定制数字人服务，生成符合要求的数字人和声音，并获取对应的数字人 ID 和声音 ID。然后，用户将这些 ID 以及视频合成其他字段参数作为 API 入参，调用合成视频的 API 服务接口，生成最终视频。整个过程涉及多次手动调用 API ，耗时较长，且需要开发者对接口调用流程非常熟悉。

LLM Agent

用户只需与 LLM Agent 进行对话，描述视频需求即可。MCP 已经提前将 APP_ID 和 APP_SECRET 配置在 JSON 文件中，因此无需手动获取 AccessToken 。MCP 会自动根据你的需求来分别调用所需的 API 服务接口，并可以根据用户需求进行不断微调，最终调用合成视频的 API 接口生成视频。整个过程无需开发者手动干预，只需要口头语与 Agent 进行聊天描述即可，极大地简化了操作流程，提高了效率。

核心功能列表

分类	工具	说明
公共方法	get_access_token	获取API调用凭证
	get_user_info	获取用户账户信息
	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	获取定制数字人列表
定制声音相关	create_customised_audio	获取定制数字人列表
	delete_customised_audio	删除定制声音
	get_customised_audio	获取定制声音详情
	list_customised_audio	获取定制声音列表

快速开始使用 MCP 客户端

通过蝉镜开放平台获取你的 APP_ID 和 APP_SECRET
选择 Stdio 本地调用 / SSE 远程服务调用其一即可

SSE 调用方式

Windsurf

前往 Windsurf > Settings > Cascade > Add Server > Add custom server 添加配置：

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

Cursor

前往 Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server 添加配置:

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

通义灵码

前往 通义灵码 -> MCP工具 -> MCP服务 -> 通过配置文件添加新增MCP服务 -> lingma_mcp.json添加以下配置:

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

Stdio 调用方式

下载蝉镜 MCP 服务文件，并转存至本地: Windows版本、Windows版本-x64、Mac版本
本地新建存放access_token.json的文件夹

通义灵码

前往 通义灵码 > MCP工具 > MCP服务 > 通过配置文件添加新增MCP服务 > lingma_mcp.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添加以下配置

{
  "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 添加以下配置

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

完成以上配置之后，你的 MCP 客户端现在就可以通过通义灵码、Windsurf、Cursor 等这些工具与蝉镜API交互了

使用示例

以 Windsurf（Stdio调用）为例

1、配置 MCP 服务

添加 MCP Server
配置 json 文件
刷新并观察 MCP Server 状态是否正常可用
若遇到 MCP 文件无法读取等非正常状态问题请检查 MCP 文件路径是否和 mcp_config.json 文件中 command 的路径是否一致，并检查 MCP 服务文件的读取权限，详情见本页内容的 Tips 部分

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

推荐使用 gpt-4o 模型

一句话描述视频需求
选择合适的数字人继续生成视频
生成视频任务自动提交
查询视频制作进度
视频成果展示

Tips

一、在 macOS 上，如果你遇到权限问题导致无法正常读写 MCP 服务文件，请确保你有对应文件或目录的访问权限。

1、打开终端（Terminal）修改文件所有者及权限：

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

2、若遇到以下Apple拦截验证，则需要手动在 设置 > 隐私与安全性 > 安全性中对 MCP 服务文件仍然允许，刷新 MCP Servers，执行 仍然打开文件 即可完成 MCP 服务部署。 Apple验证问题

二、调用方式时候中途遇到 access_token 无效的问题

1、检查是否在其他地方有调用获取 GetAccessToken 的行为导致 access_token 失效。

2、重新刷新 MCP Server 状态，并新建 Agent 对话窗口进行重试（此处的刷新 MCP Server 状态，相当于重新调用 GetAccessToken 服务，会造成之前的 access_token 失效）。

三、MCP 平台体验相关

各平台开启Auto-Run 与 Auto-Fix 使用自动化运行以及修复参数传递错误问题

1、Windsurf

2、Cursor cursor

cursor

3、通义灵码

Q&A

Q1：合成视频时遇到 Agent 回复 Call Tool 失败或者合成服务无法使用问题

A1：查看 Agent 调用服务传入以及返回的参数来判断是否服务调用存在参数错误问题，例如：利用公共数字人合成视频需要传入形态参数 figure_type、音量参数需大于0等，可以根据返回的错误结果让模型修正传参进行重试

蝉镜 MCP Server ​

概述 ​

场景介绍 ​

传统 API 调用 ​

LLM Agent ​

核心功能列表 ​

快速开始使用 MCP 客户端 ​

SSE 调用方式 ​

Windsurf ​

Cursor ​

通义灵码 ​

Stdio 调用方式 ​

通义灵码 ​

Windsurf ​

Cursor ​

使用示例 ​

以 Windsurf（Stdio调用） 为例 ​

Tips ​

一、在 macOS 上，如果你遇到权限问题导致无法正常读写 MCP 服务文件，请确保你有对应文件或目录的访问权限。 ​

二、调用方式时候中途遇到 access_token 无效的问题 ​

三、MCP 平台体验相关 ​

Q&A ​

蝉镜 MCP Server

概述

场景介绍

传统 API 调用

LLM Agent

核心功能列表

快速开始使用 MCP 客户端

SSE 调用方式

Windsurf

Cursor

通义灵码

Stdio 调用方式

通义灵码

Windsurf

Cursor

使用示例

以 Windsurf（Stdio调用）为例

Tips

一、在 macOS 上，如果你遇到权限问题导致无法正常读写 MCP 服务文件，请确保你有对应文件或目录的访问权限。

二、调用方式时候中途遇到 access_token 无效的问题

三、MCP 平台体验相关

Q&A