Longbridge MCP Server 是长桥证券提供的官方 MCP 服务器，用于将长桥券商能力接入支持 MCP 的 AI 客户端。项目使用 Rust 编写，基于 rmcp 和 axum，覆盖美股与港股市场。
用途
该服务器旨在让 MCP 客户端以自然语言方式访问市场数据与账户功能。官方说明其已在 ChatGPT Apps 目录和 Claude Connectors 目录中正式列出，用户可用普通语言查询行情、期权、基本面以及自己的投资组合，无需编辑配置文件或粘贴令牌。
主要能力
服务器提供 164 项工具，涵盖实时行情、期权、订单路由、基本面、分析师评级、财经日历、IPO、价格提醒、定投计划、网格交易、投资组合分析和社区股票列表。官方描述共二十个类别，横跨市场数据、交易、研究与账户管理。数据覆盖美国与香港市场。
每项工具支持可选参数 _jq，用于对返回的完整 JSON 做 jq 兼容过滤，该表达式在响应正常序列化之后运行。_jq 名称保留用于响应过滤，以避免与业务参数冲突。用法说明会在 MCP initialize 响应的 instructions 中发送一次，各工具的 schema 只声明该可选参数的名称与类型。例如可用 .data[:5] 取 data 数组前五项，用 .data | map(select(.price > 10)) 筛选行，用 {total: .total} 投影字段。表达式使用内嵌 jaq 引擎的 jq 兼容语法，无需单独安装 jq。省略 _jq 或传 null 时保留原始响应。单值直接返回，多值以数组返回，无值返回 []。标量和数组为 JSON 文本，对象还会出现在 structuredContent 中，仅包含过滤后的字段。纯文本响应以 JSON 字符串提供。多个内容块且无结构化内容时以数组提供。工具错误与权限/无数据说明保持不过滤。空、非法或非字符串表达式会在工具运行前被拒绝。若运行时过滤失败，响应会明确说明工具已执行，不应自动重试下单等写入操作。环境访问、文件系统导入和日志过滤不可用。输出上限为 10,000 个值和 8 MiB，超出会返回错误而非部分结果。由于过滤会改变响应形态，工具不声明固定 outputSchema，原始类型化 schema 仍可通过 resources/list 和 resources/read 在 lb://tools/{tool-name}/output-schema 获取。
使用方式
官方托管端点为 https://mcp.longbridge.com，可将任意 MCP 客户端指向该地址，并在提示时完成 OAuth。授权通过 RFC 9728 自动发现，无需粘贴令牌。Claude Desktop 需添加到 claude_desktop_config.json 后重启；Cursor、Cline、Windsurf、Zed 等客户端应指向 https://mcp.longbridge.com 并使用 streamable-http 传输。首次使用时，客户端读取 WWW-Authenticate 质询，获取 /.well-known/oauth-protected-resource（RFC 9728），并打开浏览器完成长桥 OAuth 流程；令牌按会话缓存并自动刷新。
如需自托管，可运行已发布的镜像，并将 --base-url 设为外部可访问 URL（用于 OAuth 元数据中供客户端发现授权服务器，默认 http://localhost:{port} 远程客户端无法使用）。也可从源码构建：cargo build --release && ./target/release/longbridge-mcp。配置位于 ~/.longbridge/mcp/config.json，可用 LONGBRIDGE_MCP_CONFIG_DIR 覆盖目录，CLI 标志优先。tls_cert 与 tls_key 同时设置时服务器运行 HTTPS，否则为 HTTP；base_url 在 TLS 下默认 https://localhost:{port}，无 TLS 时默认 http://localhost:{port}。中国大陆环境不是标志，而是在设置 LONGBRIDGE_REGION=cn 时自动选择（与 SDK 使用同一变量），因此大陆集群无需专门设置。上游端点由所选环境固定；Canary 使用 -global 网关而非 openapi.longbridge.xyz，因为只有前者由 CloudFront 前置并执行 x-dc-region 数据中心路由，服务器依赖其从单一进程提供 us_ 和 ap_ 前缀凭据。Canary 和大陆环境在启动时固定上述所有 URL；生产环境除使用 us_ 凭据且无上游覆盖时固定到 global .com 网关外，交由 SDK 自行解析，具体选择规则见 src/endpoints.rs。
服务器期望在 Authorization: Bearer <token> 中传入长桥 OAuth 访问令牌。缺失或无效时返回 401 并带 WWW-Authenticate 头，指向受保护资源元数据，引导客户端前往长桥 OAuth 授权服务器。在请求中发送 x-papertrading: true（或 1）可对模拟交易环境运行；上游会拒绝使用真实资金令牌发起的模拟交易请求，因此该头是安全防护而非路由开关，只能收窄令牌权限。LONGBRIDGE_PAPERTRADING=true 可为整个部署开启。
安全与限制
官方说明该服务器为无状态设计：每个请求将 Bearer 令牌直接转发给长桥 SDK，无会话、无数据库、服务端不存储任何内容。采用 OAuth 2.1 并自动发现，支持 RFC 9728 受保护资源与 RFC 8414 授权服务器元数据，客户端无需粘贴令牌即可完成流程。响应为清晰类型化格式：snake_case 字段、RFC 3339 时间戳、人类可读代码，并在 MCP 资源中提供类型化响应 schema。
MCP 请求与响应携带客户数据（现金余额、持仓、订单历史），上游 SDK 帧携带访问令牌，因此服务器会限制可能打印这些内容的日志目标，与 RUST_LOG 无关。提高详细度是安全的：RUST_LOG=debug（或 trace）可获得服务器自身日志而不泄露客户数据。两个开关可破坏此保护，均默认关闭：LONGBRIDGE_MCP_LOG_PAYLOADS=1（移除限制，仅限本地测试账户使用）和 LONGBRIDGE_LOG_PATH（使 SDK 将未过滤的响应体写入该目录，设置时服务器启动会警告）。
监控方面提供 Prometheus 指标：mcp_tool_calls_total（计数器）、mcp_tool_call_duration_seconds（直方图）、mcp_tool_call_errors_total（计数器），均按 tool_name 标注。项目以 MIT 许可证发布。定价、具体工具清单与更多使用细节，资料暂未提供。
