handoff-mcp-server

handoff-mcp-server

MCP（HTTP トランスポート）を介した、複数エージェントのワークフロー向けの永続的な引き継ぎ機能と共有スクラッチパッドです。

エンドポイント

• 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 の認証動作

• ディスカバリーメソッド（initialize、tools/list、resources/list、prompts/list、ping）は、PUBLIC_MCP_DISCOVERY=true の場合に公開できます。
• 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 には上流認証ヘッダー（MCP_API_KEY と一致する x-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

• 新しいエージェントを作成し、MCP サーバーを追加します。
  • URL：https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
  • ツール実行パス用ヘッダー：x-api-key: <MCP_API_KEY>

推奨するその他のディスカバリー掲載先

• PulseMCP ディレクトリ
• mcp.so
• OpenTools カタログ
• MCPmarket / mcpservers.org

動作の一貫性を保つため、すべての場所で同じ標準 MCP URL と対応する認証情報を使用してください。