Bloomberg MCP Gateway

Production-grade MCP-шлюз, который предоставляет агенту (Hermes), размещённому на Linux, управляемый доступ к Bloomberg Desktop API (blpapi) на рабочей станции Windows с Bloomberg Terminal, через частную сеть Tailscale.

• Протокол: stateless MCP Streamable HTTP, редакция 2026-07-28

• Транспорт: HTTPS через Tailscale Serve -> http://127.0.0.1:8765

• Bloomberg: только Desktop API, локальный 127.0.0.1:8194 (BBComm никогда не раскрывается)

• Аутентификация: приватные статические bearer-токены, сопоставленные с субъектами, принадлежащими серверу

• Безопасность: политики, бюджеты стоимости/квот, привязанные к субъектам дескрипторы, журнал аудита, защита от перегрузки по правам доступа, ограниченное хранилище результатов

• 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) для завершения HTTPS-трафика только внутри tailnet.

Статус вех

Пункты проверки на стороне Bloomberg (подключение к Terminal, entitlements, ограничения операций) требуют реально выполненного входа в Terminal; см. docs/deployment.md и scripts/environment-probe.ps1.

Заметки по безопасности

• Никогда не раскрывайте порт 8765 или порт BBComm 8194 за пределами localhost.

• Bearer-токены должны иметь энтропию не менее 256 бит; ротируйте с перекрытием.

• Ограничения политик не заменяют договорные и entitlement-ограничения Bloomberg.