Bloomberg MCP Gateway

Gateway MCP de grado de producción que proporciona a un agente alojado en Linux (Hermes) acceso controlado a la API de escritorio de Bloomberg (blpapi) en una estación de trabajo Windows con Bloomberg Terminal, a través de una red privada Tailscale.

• Protocolo: MCP Streamable HTTP sin estado, revisión 2026-07-28

• Transporte: HTTPS mediante Tailscale Serve -> http://127.0.0.1:8765

• Bloomberg: solo API de escritorio, local 127.0.0.1:8194 (BBComm nunca expuesto)

• Autenticación: tokens bearer estáticos privados asignados a principales propiedad del servidor

• Seguridad: políticas, presupuestos de coste/cuota, identificadores vinculados al principal, registro de auditoría, disyuntor de derechos, almacenamiento de resultados acotado

• CI: backend simulado determinista que permite el desarrollo y las pruebas sin una Bloomberg Terminal

Consulte SPEC.md para la especificación de diseño completa.

Estructura

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

Configuración de desarrollo (Windows)

Requiere Python 3.12 y uv. Todo el trabajo se realiza en un entorno virtual local al proyecto (.venv); los entornos globales de Python nunca se modifican.

# 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

Sin uv, el flujo equivalente en Python puro es:

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

Ejecución del gateway

# 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

El gateway se vincula a 127.0.0.1:8765 por defecto y se niega a iniciarse dos veces (mutex con nombre de Windows). Configure Tailscale Serve por separado (scripts/configure-tailscale.ps1) para terminar HTTPS exclusivo de tailnet.

Estado de los hitos

Los elementos de verificación del lado de Bloomberg (conectividad del Terminal, derechos, límites de operación) requieren un Terminal con sesión iniciada real; consulte docs/deployment.md y scripts/environment-probe.ps1.

Notas de seguridad

• Nunca exponga el puerto 8765 ni el puerto BBComm 8194 más allá de localhost.

• Los tokens bearer deben tener >= 256 bits de entropía; rote con una superposición acotada.

• Los límites de las políticas no sustituyen los límites contractuales o de derechos de Bloomberg.