Bloomberg MCP Gateway

本番グレードのMCPゲートウェイ。Linux上でホストされるエージェント（Hermes）に、プライベートなTailscaleネットワークを介して、Windows Bloomberg Terminalワークステーション上のBloomberg Desktop API（blpapi）への制御付きアクセスを提供します。

• プロトコル: ステートレスMCP Streamable HTTP、リビジョン 2026-07-28

• トランスポート: Tailscale Serve -> http://127.0.0.1:8765 を介したHTTPS

• Bloomberg: Desktop APIのみ、ローカル 127.0.0.1:8194（BBCommは公開しない）

• 認証: サーバー所有のプリンシパルにマッピングされたプライベートな静的ベアラートークン

• セーフティ: ポリシー、コスト/クォータ予算、プリンシパルバインドハンドル、監査証跡、エンタイトルメントサーキットブレーカー、上限付き結果ストレージ

• CI: 決定論的なフェイクバックエンドにより、Bloomberg Terminalなしで開発・テストが可能

完全な設計仕様は SPEC.md を参照してください。

レイアウト

src/bloomberg_mcp/   gateway implementation (native blpapi confined to blp/)
config/              default configuration and policy examples
scripts/             PowerShell deployment and operations scripts
tests/               unit, property and contract tests (fake backend)
docs/                architecture, deployment, security and operations docs

Related MCP server: Bloomberg MCP

開発環境のセットアップ（Windows）

Python 3.12とuvが必要です。すべての作業はプロジェクトローカルの仮想環境（.venv）で行われ、グローバルなPython環境に触れることはありません。

# 1. Create the isolated virtual environment
uv venv

# 2. Install the gateway with dev tooling (blpapi is fetched from the
#    Bloomberg package index automatically, see pyproject.toml)
uv sync --extra dev

# 3. Run the test suite against the deterministic fake backend
uv run pytest

# 4. Lint and type-check
uv run ruff check src tests
uv run mypy

uvを使わない場合、同等のプレーンなPythonフローは次のとおりです：

python -m venv .venv
.venv\Scripts\python -m pip install -e ".[dev]" `
  --extra-index-url https://blpapi.bloomberg.com/repository/releases/python/simple/

ゲートウェイの実行

# Fake backend (no Bloomberg Terminal required)
uv run bloomberg-mcp --backend fake

# Native backend (Bloomberg Terminal must be running and logged on)
uv run bloomberg-mcp --config config/default.yaml --policy config/policy.example.yaml

ゲートウェイはデフォルトで 127.0.0.1:8765 にバインドされ、二重起動を拒否します（Windows名前付きミューテックス）。Tailscale Serve（scripts/configure-tailscale.ps1）を個別に設定して、tailnet限定のHTTPSを終端します。

マイルストーンのステータス

Bloomberg側の検証項目（Terminal接続、エンタイトルメント、操作制限）には、実際にログオンしたTerminalが必要です。docs/deployment.md と scripts/environment-probe.ps1 を参照してください。

セキュリティに関する注意事項

• ポート8765やBBCommポート8194をlocalhostの範囲外に公開しないでください。

• ベアラートークンは256ビット以上のエントロピーが必要です。境界付きオーバーラップでローテーションしてください。

• ポリシー制限は、Bloombergの契約上またはエンタイトルメント上の制限に代わるものではありません。