Skip to main content
Glama
JohnJohnJohnJohn

Bloomberg MCP Gateway

Bloomberg MCP Gateway

生产级 MCP 网关,通过私有 Tailscale 网络,让 Linux 托管的代理(Hermes)受控访问 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。

里程碑状态

里程碑

范围

状态

0

环境探测 + 兼容性锁定

见 compatibility.lock.yaml

1

核心通用网关(假 + 原生适配器)

已实现

2

生产生命周期(重连、配额、存储、审计)

已实现

3

订阅

已实现

4

精选工具 + 规范化器

已实现

Bloomberg 侧验证项(Terminal 连接、权限、操作限制)需要实际登录的 Terminal;见 docs/deployment.md 和 scripts/environment-probe.ps1。

安全说明

  • 切勿在 localhost 之外暴露端口 8765 或 BBComm 端口 8194。

  • Bearer 令牌必须具有 >= 256 位的熵;以有界重叠方式轮换。

  • 策略限制不能替代 Bloomberg 合同或权限限制。

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A centralized gateway platform for aggregating and managing multiple Model Context Protocol (MCP) servers through a single Electron-based interface. It provides enterprise-grade security features including policy-based access control, human-in-the-loop approval workflows, and comprehensive audit logging.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that bridges AI assistants with Bloomberg Terminal data. It exposes 18 tools for reference, historical, technical analysis, screening, and calendar data through natural language.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides a local Windows control plane for PowerShell and AI CLIs, exposing MCP tools for safe terminal sessions, bounded provider calls, routing, committees, and run receipts.
    5 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides a fail-closed MCP bridge to QMT trading terminals, enabling observe-only, simulated, manual live, and limited automatic trading with hard risk controls, two-phase trade intents, and strict authorization checks.
    1
    MIT