Handoff Mcp Server

io.github.josephibra由 GitHub 账号 josephibra 发布v1.0.1更新于 Oct 24, 2026

Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.

已验证Streamable HTTP可网页运行知识与记忆AI 与机器学习

概览

AI 生成的概览

一个远程 MCP 服务,提供持久的智能体间交接和共享草稿板,让多个智能体互相传递任务与笔记。

可以做什么
以持久交接的方式在智能体之间传递工作,使一个智能体开始的任务能由另一个接手而不丢失状态(依据描述与 README)。提供共享草稿板,供多个智能体在多智能体流程中共同读写。通过 HTTP 的 MCP 端点对外提供服务,另有服务信息、健康与存储统计以及发现文件等端点。README 未列出具体工具,因此此处不说明确切的工具集合。
适用场景
适合运行多智能体流程、需要智能体之间交接任务或跨步骤共享工作笔记,而不是把所有内容都放在单个智能体的上下文里时使用。
运行要求
通过 streamable HTTP 访问的远程端点;声明需要 OAuth 认证。README 还说明工具调用需要以 Bearer 令牌或 x-api-key 请求头提供 API 密钥,经 Xpay 主机访问时还需在 URL 查询参数中带上 Xpay 密钥。无需本地运行时。
安装前请注意
README 在多处要求提供密钥:请求头中的 API 密钥,以及 URL 查询字符串中的 Xpay 密钥,后者可能通过日志和分享链接泄露。工具调用需要有效认证,README 指出缺少 Xpay 密钥的请求不会被转发。交接内容和草稿板内容存储在服务端,写入的内容会离开本机,请勿在共享笔记中放入敏感数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Handoff Mcp Server,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.josephibra%2Fhandoff-mcp-server/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "handoff": {
      "type": "http",
      "url": "https://handoff-mcp-server-production.mcp.xpay.sh/mcp"
    }
  }
}

README

handoff-mcp-server

Durable handoffs and shared scratchpad for multi-agent workflows over MCP (HTTP transport).

Endpoints

  • GET / basic service info
  • GET /health health and storage stats
  • POST /mcp JSON-RPC MCP endpoint
  • GET /robots.txt discovery file
  • GET /llms.txt discovery file
  • GET /sitemap.xml discovery file

Environment Variables

  • PORT default 3000
  • DATA_DIR default /data
  • MCP_API_KEY required in production (NODE_ENV=production)
  • PUBLIC_MCP_DISCOVERY default true
  • PUBLIC_BASE_URL optional, used for absolute links in discovery files

Local Run

bash
npm cinpm run buildMCP_API_KEY=test-secret node dist/index.js

MCP Auth Behavior

  • Discovery methods (initialize, tools/list, resources/list, prompts/list, ping) can be public when PUBLIC_MCP_DISCOVERY=true.
  • tools/call requires valid upstream auth when MCP_API_KEY is set:
    • Authorization: Bearer <MCP_API_KEY> or
    • x-api-key: <MCP_API_KEY>

Xpay + Railway Configuration (Required)

  1. Railway variables:
  • MCP_API_KEY=<your-strong-key>
  • PUBLIC_MCP_DISCOVERY=true
  • PUBLIC_BASE_URL=https://handoff-mcp-server-production.up.railway.app
  1. Xpay MCP URL:
  • Use https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
  • Without ?key=..., Xpay returns auth required and requests will not forward.
  1. Client calls through Xpay:
  • Keep the Xpay key in URL.
  • Also send upstream auth header for tools/call (x-api-key or Bearer token matching MCP_API_KEY).

Publishing

MCP Registry

  • Server name: io.github.josephibra/handoff-mcp-server
  • Primary remote: Xpay URL (with key at client usage time, not committed)
  • Secondary remote: Railway URL

Smithery

  • Namespace: josephibrahim
  • Server ID: handoff-mcp-server
  • MCP Server URL: https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...

Agentverse

  • Create a new agent and attach MCP server:
    • URL: https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
    • Headers: x-api-key: <MCP_API_KEY> for tool execution paths

Recommended Extra Discovery Listings

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

Use the same canonical MCP URL and matching auth notes everywhere to avoid inconsistent behavior.

来源:README.md,提交 43de49c

工具

0
该服务器需要 API 密钥等凭据,因此 SourceWeft 无法在没有凭据的情况下读取其工具,也未收录。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。