Bridge Town

Bridge Town MCP 连接器

通过云端执行、Native Sheets、Google Sheets、版本控制和协作，以代码构建财务模型。

此公开代码库包含文档、注册表元数据、精简的 stdio-to-HTTP 转接层，以及带版本号的模型编写辅助工具，供托管版 Bridge Town MCP 连接器使用。商业版服务端实现由 Bridge Town 运营，未在此处发布。

• 网站：https://www.bridgetown.builders
• 应用：https://app.bridgetown.builders
• 文档：https://www.bridgetown.builders/docs/
• MCP 端点：https://api.bridgetown.builders/mcp
• 传输方式：MCP Streamable HTTP
• 身份验证：托管连接器流程使用 OAuth；手动配置客户端时使用 bearer 令牌

Bridge Town 不运行服务端大模型，也不代理提示词。用户选择的 AI 客户端和模型提供商负责运行对话；Bridge Town 接收类型化 MCP 调用，并执行确定性的平台操作。

连接

对于 Claude.ai，请将 https://api.bridgetown.builders/mcp 添加为自定义连接器，并批准 Bridge Town OAuth 提示。

对于支持 Streamable HTTP 和标头的客户端：

{
  "mcpServers": {
    "bridge-town": {
      "transport": {
        "type": "http",
        "url": "https://api.bridgetown.builders/mcp",
        "headers": {
          "Authorization": "Bearer btk_YOUR_TOKEN"
        }
      }
    }
  }
}

在 https://app.bridgetown.builders/connect 生成和撤销 API 令牌。有关设置、当前任务流程和故障排查，请参阅入门指南。

规范 MCP 接口

生产环境端点提供一套规范工具目录。使用 search_tools 查找适用于目标的当前正确工具，并使用 get_tool 获取其完整架构。该目录不会因客户端或用户代理而变化。

此公开列表的规范注册表清单为 server.json。它指向托管的远程 MCP 服务，并非专有服务端实现的副本。

带版本号的模型编写辅助工具

适用于在模型代码库中运行的小型辅助模块，以不可变的 MIT 许可版本发布：

• native_sheet_reader.py v1.1.0 保留 Native Sheet 的缺失、空白和公式状态，并生成有界且不含值的读取标识。
• output_lineage.py v1.1.0 生成经过验证的 output_lineage.json 依赖关系图。

v1.1.0 版本目录包含可运行示例、变更日志、所有权信息、许可证、清单和 SHA256SUMS。请严格按照清单中的 target_path 逐字节安装辅助工具，并在将其提交到模型代码库之前验证其摘要。

本地 stdio 转接层

大多数客户端应直接连接到 Streamable HTTP 端点。需要 stdio 的本地 MCP 宿主可以使用精简的转发转接层：

BRIDGE_TOWN_API_TOKEN=btk_YOUR_TOKEN npx github:Bridge-Town/financial-modeling-mcp

该转接层不会读取或写入本地文件，也不会启动子进程。它只会通过 HTTPS 将 MCP JSON-RPC 消息转发到配置的 Bridge Town MCP 端点。

安全

财务模型在隔离容器中运行，无法访问出站网络。Google 访问使用 drive.file，将 Bridge Town 的权限限制为通过 Bridge Town 流程选定或由 Bridge Town 创建的文件。

请通过 SECURITY.md 私下报告漏洞。请勿创建公开问题，也不要在报告中包含客户数据。

治理

• 支持
• 贡献与贡献范围
• 公开与私有源代码范围
• 所有权
• MIT 许可证

治理文件根据封闭且带版本号的 directory-resources.v1.json 元数据契约生成。