Bloomberg MCP Gateway

Produktionsreifer MCP-Gateway, der einem auf Linux gehosteten Agenten (Hermes) kontrollierten Zugriff auf die Bloomberg Desktop API (blpapi) auf einer Windows-Bloomberg-Terminal-Workstation über ein privates Tailscale-Netzwerk gewährt.

• Protokoll: zustandsloses MCP Streamable HTTP, Revision 2026-07-28

• Transport: HTTPS über Tailscale Serve -> http://127.0.0.1:8765

• Bloomberg: Nur Desktop API, lokal 127.0.0.1:8194 (BBComm wird nie exponiert)

• Auth: private statische Bearer-Tokens, die server-eigenen Prinzipalen zugeordnet sind

• Sicherheit: Richtlinien, Kosten-/Kontingentbudgets, prinzipalgebundene Handles, Audit-Trail, Berechtigungs-Circuit-Breaker, begrenzte Ergebnisspeicherung

• CI: deterministisches Fake-Backend ermöglicht Entwicklung und Tests ohne Bloomberg-Terminal

Siehe SPEC.md für die vollständige Designspezifikation.

Layout

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

Entwicklungs-Setup (Windows)

Erfordert Python 3.12 und uv. Die gesamte Arbeit findet in einer projektspezifischen virtuellen Umgebung (.venv) statt; globale Python-Umgebungen werden nie berührt.

# 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

Ohne uv sieht der äquivalente reine Python-Ablauf wie folgt aus:

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

Ausführen des Gateways

# 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

Das Gateway bindet standardmäßig an 127.0.0.1:8765 und weigert sich, zweimal zu starten (Windows-Named-Mutex). Konfigurieren Sie Tailscale Serve separat (scripts/configure-tailscale.ps1), um HTTPS nur im Tailnet zu beenden.

Meilenstein-Status

Verifizierungspunkte auf Bloomberg-Seite (Terminal-Konnektivität, Berechtigungen, Betriebsgrenzen) erfordern ein tatsächlich angemeldetes Terminal; siehe docs/deployment.md und scripts/environment-probe.ps1.

Sicherheitshinweise

• Exponieren Sie Port 8765 oder BBComm-Port 8194 niemals über localhost hinaus.

• Bearer-Tokens müssen eine Entropie von >= 256 Bit aufweisen; rotieren Sie sie mit begrenzter Überlappung.

• Richtlinienlimits ersetzen nicht die vertraglichen oder Berechtigungslimits von Bloomberg.