Bloomberg MCP Gateway

프로덕션 등급 MCP 게이트웨이로, Linux에서 호스팅되는 에이전트(Hermes)가 비공개 Tailscale 네트워크를 통해 Windows Bloomberg Terminal 워크스테이션의 Bloomberg Desktop API(blpapi)에 통제된 접근 권한을 얻을 수 있게 합니다.

• 프로토콜: 상태 비저장 MCP Streamable HTTP, 리비전 2026-07-28

• 전송: Tailscale Serve를 통한 HTTPS -> 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)하여 tailnet 전용 HTTPS를 종료하세요.

마일스톤 상태

Bloomberg 측 검증 항목(터미널 연결, 권한, 운영 한도)은 실제 로그온된 터미널이 필요합니다. docs/deployment.md 및 scripts/environment-probe.ps1을 참조하세요.

보안 참고 사항

• 포트 8765 또는 BBComm 포트 8194를 localhost 밖으로 노출하지 마세요.

• Bearer 토큰은 256비트 이상의 엔트로피를 가져야 하며, 제한된 오버랩으로 교체해야 합니다.

• 정책 한도는 Bloomberg 계약 또는 권한 한도를 대체하지 않습니다.