custodyops-mcp-python

最小限のPython MCPサーバーで、Streamable HTTP上で動作し、FastAPI + fastmcp を使用しています。Render で HTTPS 対応のデプロイが可能です。ping ツールと2つのデモツール（get_positions、list_upcoming_corporate_actions）を公開しており、これらはカストディデータへの読み取り専用アダプターに置き換えることができます。

なぜ Streamable HTTP なのか？ リモート/ホスト型 MCP サーバーに推奨されるトランスポートであり、双方向ストリーミングを単一の POST /mcp エンドポイントに簡略化し、クラウドデプロイを容易にします。正規のパターンについては MCP HTTP クイックスタートおよび SDK ドキュメントを参照してください。

機能

• POST /mcp の Streamable HTTP エンドポイント

• Bearer 認証（AUTH_TOKEN 経由）

• /health エンドポイント（稼働確認用）

• 最小限のコード量で、さらに MCP ツールを追加しやすい

• render.yaml による ワンクリックデプロイ（Render 対応）

Related MCP server: MCP Ping-Pong Server

クイックスタート（ローカル）

python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scriptsctivate
pip install -r requirements.txt
export AUTH_TOKEN=devtoken123
export PORT=3000
uvicorn app:app --host 0.0.0.0 --port $PORT

cURL でテスト:

# tools/list
curl -s -X POST http://localhost:3000/mcp   -H "Content-Type: application/json"   -H "Authorization: Bearer devtoken123"   -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}' | jq

# tools/call ping
curl -s -X POST http://localhost:3000/mcp   -H "Content-Type: application/json"   -H "Authorization: Bearer devtoken123"   -d '{"jsonrpc":"2.0","id":"2","method":"tools/call","params":{"name":"ping","arguments":{}}}' | jq

またはヘルパースクリプトを実行:

chmod +x scripts/test_locally.sh
AUTH_TOKEN=devtoken123 PORT=3000 ./scripts/test_locally.sh

Render にデプロイ（HTTPS）

1. このリポジトリを フォークまたはプッシュ して自分の GitHub に追加します。

2. Render で: New → Web Service → Connect repo。

3. render.yaml の設定を確認します（Python 環境、フリープラン）。Render は自動的に HTTPS をプロビジョニングします。

4. Render の Environment で AUTH_TOKEN を設定します（ブループリントを使用する場合は自動生成されます）。

5. デプロイ → パブリックな MCP エンドポイントは次のようになります: https://<your-app>.onrender.com/mcp。

リモートでテスト:

APP_URL=https://<your-app>.onrender.com AUTH_TOKEN=<token> ./scripts/test_remote.sh

Claude Desktop から使用する（リモート MCP）

claude_desktop_config.json にリレーエントリを追加:

{
  "mcpServers": {
    "custodyops-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://<your-app>.onrender.com/mcp"],
      "env": { "AUTH_TOKEN": "<same-token>" }
    }
  }
}

アプリを再起動し、Claude に利用可能なツールを尋ねます。

実際のカストディデータで拡張する

デモツールを、データマートまたは API への読み取り専用アダプターに置き換えます。レスポンスは 小さく型付けされた ものにし、可能な限りフィールドの出所を追加します。

スケルトン例:

@mcp_tool
def get_positions(account_id: str) -> str:
    rows = query_positions(account_id)  # your adapter
    return json.dumps(rows)

セキュリティ上の注意

• AUTH_TOKEN は秘密に保ち、定期的にローテーションします。エンタープライズ用途では、OAuth/JWT に移行し、アカウントごとの認可を追加します。

• HTTP トランスポート の場合、通常のログ記録で問題ありませんが、機密データは編集し、リクエスト ID を追加します。

ライセンス

MIT