Cicadas local MCP

Cicadas 本地 MCP

面向 Cicadas.ai 客户 API 的实验性本地 stdio 桥接程序。

尚未在生产环境中验证需要身份验证的功能。 此版本通过了本地契约测试，以及打包后的 MCP 握手和工具列表检查。验收过程中未使用真实客户 API 密钥。此版本尚未验证与账户绑定的目录、余额、报价、任务查询、密钥撤销、生成、下载和退款流程。未执行付费生成测试。

提供的功能

默认工具	对应的客户 API 操作
list_video_models	读取可用的文本转视频模型目录
get_credit_balance	读取账户余额和密钥预算
quote_video	验证请求并估算所需积分，不创建任务
get_video_job	查询已拥有任务的状态
get_video_request	通过原始 UUID 找回已拥有的请求，不重新提交生成请求

所有工具都需要有效的 Cicadas 客户 API 密钥。浏览器会话、提供商密钥或管理员密钥均不能替代客户 API 密钥。此软件包不包含账户访问权限。读取已有任务状态时可能会执行提供商状态／退款维护；请参阅客户 API 详情。

安装 MCPB 捆绑包

从此仓库的 v0.1.0 发行版下载 cicadas-local-mcp-0.1.0.mcpb。请使用支持 MCPB Node 捆绑包和 Node.js 22 或更高版本的 MCP 宿主。导入捆绑包，并在敏感配置字段中输入妥善保管且最好为只读的客户 API 密钥。

提供的 MCPB 配置将 CICADAS_ENABLE_GENERATION=0，因此只会提供上述五种工具。切勿将密钥放入提示词、问题报告、日志、屏幕截图或提交的配置中。

从源代码运行

需要 Node.js 22 或更高版本。

npm ci --ignore-scripts
npm test
npm start

将 MCP 宿主配置为运行 node /absolute/path/to/src/server.mjs，并通过宿主的私有环境配置提供 CICADAS_API_KEY。API 基础 URL 默认为 https://cicadas.ai/api/v1/。这是本地 stdio 程序，不是托管的远程 MCP 端点或 OAuth 连接器。

可选的源代码配置

底层桥接程序支持设置 CICADAS_ENABLE_GENERATION=1 以提供 create_video。提供的捆绑包中已禁用此功能。生成还需要启用了生成权限的客户密钥、明确设置 confirmSpend: true、UUID 请求 ID 和积分上限。此版本尚未测试付费生成和交付。

CICADAS_DOWNLOAD_DIRECTORY 可选地为现有本地目录提供 download_video。下载使用 UUID 文件名，拒绝覆盖文件，并返回本地路径和 SHA-256。此版本尚未在生产环境中验证下载交付。

自定义 HTTPS 基础 URL 需要设置 CICADAS_ALLOW_CUSTOM_ORIGIN=1；环回 HTTP 还需要设置 CICADAS_ALLOW_HTTP_LOOPBACK=1。这些都是本地操作员设置，不能作为工具输入。桥接程序会拒绝重定向和 Cookie 身份验证。若付费生成遇到不确定状态，桥接程序不会自动重试。请使用原始请求 UUID 找回请求。

验证与范围

• 已有桥接程序契约测试：在 Node.js 22.23.2 上通过 6 项。
• 已提取的 MCPB：SDK 握手和五种默认工具的列表检查通过；未提供生成功能。
• 两个桥接程序源文件与现有 Cicadas 可下载桥接程序完全相同。
• 本地测试使用模拟服务器。这些测试无法证明已通过身份验证的生产环境可用性、提供商输出、存储交付、付款／退款行为或视觉质量。
• 此仓库仅包含独立桥接程序及其文档，不包含 Cicadas 网站应用。

网站 · 客户 API 详情 · 隐私政策