内容
# @clipy/mcp
为您的 AI 代理提供访问您的 [Clipy](https://clipy.online) 屏幕录制功能。
这是一个 [模型上下文协议](https://modelcontextprotocol.io)（MCP）服务器。它允许
Claude、Cursor、Windsurf 和其他支持 MCP 的代理 **搜索您的录制文件并读取它们的转录文本、AI 摘要和关键时刻**，包括演讲者所指位置的视频帧，以内联图像的形式呈现，您的代理可以直接查看。这样，您可以执行诸如 _"阅读此错误报告录制文件并交付修复"_ 之类的操作，而无需离开您的代理。
> **零设置替代方案：** 每个公共 Clipy 分享链接也适用于代理可读，无需此服务器 — 只需追加 `.md`（例如 `clipy.online/video/<id>.md`），任何可以获取 URL 的代理都可以获取摘要、关键时刻（附带帧）和带时间戳的转录文本。MCP 服务器添加了私有库搜索、内联帧图像和一次性上下文包。更多信息请访问 [clipy.online/for-agents](https://clipy.online/for-agents)。
它是 **只读** 的：它永远无法创建、编辑或删除您的录制文件。
## 设置
1. 在 **https://clipy.online/settings/api-keys** 处创建一个免费的 API 密钥（它类似于 `clipy_sk_live_…`）。复制它 — 它只显示一次。
2. 将服务器添加到您的 MCP 客户端。
### Claude 代码
`--scope user` 标志会全局安装 Clipy，适用于所有项目。如果没有它，`claude mcp add` 默认设置为 `local` 范围（仅当前文件夹）：
```bash
claude mcp add --scope user clipy --env CLIPY_API_KEY=clipy_sk_live_xxx -- npx -y @clipy/mcp
```
### Codex
这会将服务器写入您的全局 `~/.codex/config.toml`，因此它在每个 Codex 会话中都可用：
```bash
codex mcp add clipy --env CLIPY_API_KEY=clipy_sk_live_xxx -- npx -y @clipy/mcp
```
或者手动将其添加到 `~/.codex/config.toml`：
```toml
[mcp_servers.clipy]
command = "npx"
args = ["-y", "@clipy/mcp"]
env = { CLIPY_API_KEY = "clipy_sk_live_xxx" }
```
### Claude Desktop / Cursor / Windsurf
直接编辑匹配的 **用户级** 配置（`claude_desktop_config.json`、`~/.cursor/mcp.json` 或 Windsurf MCP 配置）：
```json
{
"mcpServers": {
"clipy": {
"command": "npx",
"args": ["-y", "@clipy/mcp"],
"env": { "CLIPY_API_KEY": "clipy_sk_live_xxx" }
}
}
}
```
## 工具
| 工具 | 功能 |
| --- | --- |
| `search_recordings` | 按关键词（标题 + 描述）搜索您的录制文件。 |
| `list_recordings` | 列出您最近的录制文件。 |
| `get_recording` | 获取单个录制文件的元数据（状态、时长、转录/摘要状态）。 |
| `get_transcript` | 获取完整的带时间戳的转录文本 + 明文。 |
| `get_summary` | 获取 AI 摘要：TL;DR、关键点、行动项。 |
| `wait_for_artifacts` | 轮询直到录制文件的转录/摘要完成处理。 |
| `download_recording` | 下载 MP4 文件到本地，以便您可以剪辑它或自己提取帧（例如，使用 ffmpeg）。 |
所有工具都接受录制文件的 **公共 ID**（其分享 URL 中的斜杠）或完整的 `https://clipy.online/video/<id>` URL。
## 配置
| 环境变量 | 是否必需 | 默认值 | 备注 |
| --- | --- | --- | --- |
| `CLIPY_API_KEY` | 是 | — | 您在 `/settings/api-keys` 处的个人密钥。 |
| `CLIPY_API_URL` | 否 | `https://clipy.online` | 自托管/预发布环境的覆盖。 |
## 隐私
您的密钥仅用于读取 **您自己的** 录制文件。您可以在 `/settings/api-keys` 处随时撤销它。服务器在您的本地机器上运行；您的密钥永远不会发送到任何地方，只会通过 HTTPS 发送到 Clipy API。
