handoff-mcp-server

handoff-mcp-server

通过 MCP（HTTP 传输）为多 Agent 工作流提供持久交接和共享草稿区。

端点

• GET / 基本服务信息
• GET /health 健康状态和存储统计信息
• POST /mcp JSON-RPC MCP 端点
• GET /robots.txt 发现文件
• GET /llms.txt 发现文件
• GET /sitemap.xml 发现文件

环境变量

• PORT 默认值为 3000
• DATA_DIR 默认值为 /data
• MCP_API_KEY 在生产环境（NODE_ENV=production）中必需
• PUBLIC_MCP_DISCOVERY 默认值为 true
• PUBLIC_BASE_URL 可选，用于发现文件中的绝对链接

本地运行

npm ci
npm run build
MCP_API_KEY=test-secret node dist/index.js

MCP 身份验证行为

• 当 PUBLIC_MCP_DISCOVERY=true 时，发现方法（initialize、tools/list、resources/list、prompts/list、ping）可以公开访问。
• 设置了 MCP_API_KEY 时，tools/call 需要有效的上游身份验证：
  • Authorization: Bearer <MCP_API_KEY>，或
  • x-api-key: <MCP_API_KEY>

Xpay + Railway 配置（必需）

1. Railway 变量：

• MCP_API_KEY=<your-strong-key>
• PUBLIC_MCP_DISCOVERY=true
• PUBLIC_BASE_URL=https://handoff-mcp-server-production.up.railway.app

2. Xpay MCP URL：

• 使用 https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
• 如果没有 ?key=...，Xpay 会返回需要身份验证的错误，请求也不会转发。

3. 通过 Xpay 发起客户端调用：

• 将 Xpay 密钥保留在 URL 中。
• 同时为 tools/call 发送上游身份验证标头（x-api-key 或与 MCP_API_KEY 匹配的 Bearer 令牌）。

发布

MCP Registry

• 服务名称：io.github.josephibra/handoff-mcp-server
• 主要远程服务：Xpay URL（在客户端使用时附带密钥，不要提交密钥）
• 次要远程服务：Railway URL

Smithery

• 命名空间：josephibrahim
• 服务 ID：handoff-mcp-server
• MCP 服务 URL：https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...

Agentverse

• 创建一个新 Agent 并附加 MCP 服务：
  • URL：https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
  • 标头：工具执行路径使用 x-api-key: <MCP_API_KEY>

建议添加的其他发现目录

• PulseMCP directory
• mcp.so
• OpenTools catalog
• MCPmarket / mcpservers.org

请在所有位置使用相同的规范 MCP URL 和匹配的身份验证说明，以避免行为不一致。