clypt

@useclypt/mcp-server

适用于 Clypt 的模型上下文协议服务。让 AI Agent（Claude Desktop、Cursor、Claude Code，以及任何兼容 MCP 的客户端）提交播客 URL，并获取剪辑片段、可选预告片、节目笔记、嘉宾分享链接和转录文本。

这是对 https://useclypt.com/api/v1 公共 REST API 的纯封装——仅包含三个工具，没有复杂的中间件。

工具

工具	封装的接口	返回内容
submit_job	POST /v1/jobs	{ id, status: 'queued', ... } — 启动处理流程。从提交到任务结束：音频/RSS 来源约需 2-5 分钟，视频 + 预告片约需 10-12 分钟。
get_job	GET /v1/jobs/{id}	当前任务状态。当 status='complete' 时，output 包含剪辑片段、可选预告片、guest_share_url、show_notes 和转录文本。当状态为 failed 时，error 会附带 code 和 message。
list_jobs	GET /v1/jobs	组织最近任务的游标分页列表。

此流程为异步：submit_job 会立即返回一个排队中的任务 ID；Agent 会轮询 get_job，直到任务结束。在组织中注册 webhook 后，每次任务进入终止状态都会触发 job.completed 和 job.failed 事件——通过 POST /v1/webhooks 调用公共 API 进行注册（目前还没有对应的 MCP 工具；计划在后续的小版本中推出）。

试用

在 Claude Desktop 中配置此服务后，提出以下请求：

使用 Clypt 剪辑这个播客，完成后告诉我：https://feeds.simplecast.com/abc123

Claude 会调用 submit_job，获取任务 ID，轮询 get_job 直到任务结束，然后在对话中显示剪辑片段 + 预告片 + 转录文本。从提交到完成：音频/RSS 约需 2-5 分钟，视频 + 预告片约需 10-12 分钟。

安装

npm install -g @useclypt/mcp-server

也可以不安装直接运行：

npx -y @useclypt/mcp-server

配置

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "@useclypt/mcp-server"],
      "env": {
        "CLYPT_API_KEY": "clk_live_..."
      }
    }
  }
}

重启 Claude Desktop。然后输入提示词："使用 Clypt 剪辑这个播客：<RSS 或音频 URL>"。

Cursor / Claude Code / 其他 MCP 宿主

配置方法相同——二进制文件为 mcp-server（也可以通过 npx -y @useclypt/mcp-server 运行，无需全局安装），且唯一必需的环境变量是 CLYPT_API_KEY。

沙盒密钥（免费测试）

如果你的密钥以 clk_test_ 而非 clk_live_ 开头，每个任务都会返回确定性的固定测试数据，而不会运行实际处理流程。无需支付转录费用、R2 存储费用或 Stripe 费用。可在提交真实任务前用于配置 Agent。

固定数据映射：

• source.type='video_url'（任意 URL）→ 返回包含 3 个剪辑片段 + 可选预告片的成功固定数据
• source.type='audio_url' / rss_feed_url（不含 "fail" 的 URL）→ 返回成功固定数据
• 任何包含 "fail" 的 URL → 返回 transcription_failed 错误固定数据
• source.type='youtube_url' → 返回 youtube_ingestion_failed 错误固定数据
• 格式错误的 URL → 提交时返回 invalid_source_url 验证错误

几秒钟即可在 useclypt.com/developers/signup 获取沙盒密钥——无需信用卡，也无需排队。沙盒密钥（前缀为 clk_test_）会返回确定性的固定测试数据，让你可以先免费配置 Agent，再换用 clk_live_ 密钥。

环境变量

变量	必需	默认值	用途
CLYPT_API_KEY	是	—	Clypt API 的 Bearer 令牌。clk_live_* 或 clk_test_*。
CLYPT_BASE_URL	否	https://useclypt.com	覆盖默认地址，用于预发布或本地开发。末尾斜杠会被移除。

开发

npm install
npm run build
npm test              # vitest unit tests with mocked fetch
npm run dev           # tsc --watch

使用 MCP inspector CLI 对接线上 API 进行冒烟测试：

npm run build
CLYPT_API_KEY=clk_test_xxx \
  npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

了解更多

• API 参考：useclypt.com/developers/docs
• 获取密钥：useclypt.com/developers/signup
• 关于 Clypt：useclypt.com

许可证

MIT — 参见 LICENSE。