claude-handoff-mcp

第一个用于 Claude Design 交付包的开源 MCP 服务器。

在 Cursor、Claude Code、Cline、Windsurf 或任何兼容 MCP 的客户端中粘贴 Claude Design 交付 URL，交付包就会出现在您的项目中，随时可以发布。

Paste handoff URL  →  MCP fetches, extracts, summarizes the README,
                      and deploys files into your repo. One tool call.

为什么

Claude Design（Anthropic Labs，于 2026 年 4 月 17 日发布）将设计导出为从 api.anthropic.com/v1/design/h/<hash> 提供的交付 URL。目前，使用它们意味着：下载 tar 包、解压、阅读 README、弄清楚要将什么复制到哪里。此 MCP 将其简化为代理 IDE 中的一个步骤。

• 状态： 社区项目。与 Anthropic 无关。

• 范围： 封装公开提供的交付包格式。无爬取，无除已发布的交付 URL 之外的未记录端点，无 claude.ai 会话欺骗。

Related MCP server: Claude Figma MCP

公开的工具

安装

npm install -g @kiwuuu/claude-handoff-mcp

在 Claude Code 中使用

添加到您的 MCP 配置（~/.claude.json 或您的客户端读取 MCP 服务器的任何位置）：

{
  "mcpServers": {
    "claude-handoff": {
      "command": "npx",
      "args": ["-y", "@kiwuuu/claude-handoff-mcp"]
    }
  }
}

然后在聊天中：

获取 https://api.anthropic.com/v1/design/h/abc123 并将其部署到 ./public/

在 Cursor / Cline / Windsurf 中使用

配置格式相同 — 指向 npx 条目。请参阅每个客户端的 MCP 文档以获取确切文件。

直接使用 CLI

npx claude-handoff one-shot https://api.anthropic.com/v1/design/h/abc123 ./my-app/public

注意事项

• 交付 URL 会过期。 它们具有 TTL，并且可能是单次使用的。共享菜单导出是获取新 URL 的唯一方法 — 没有公共列表端点。如果 fetch_handoff 返回 HTTP 404，则说明 URL 已过期；请从 claude.ai/design 重新导出。

• 不使用 API 密钥。 此工具仅调用公共交付 URL。它不需要 ANTHROPIC_API_KEY。

• 格式稳定性。 交付包格式是观察到的，而非指定的。如果 Anthropic 更改了它，此工具将进行调整或暂停。

贡献

欢迎提交问题和 PR。核心获取/提取/部署逻辑在 src/core.ts 中不到 400 行代码 — 易于阅读，易于分叉。

许可证

MIT。请参阅 LICENSE。