Skip to content

MCP 集成

Jump to bottom
zhenhun edited this page Sep 4, 2026 · 2 revisions

中文 | English

BIT 支持接入外部 MCP（Model Context Protocol）服务器，扩展工具集。

配置方式

MCP 服务器配置存放在数据目录的 mcp_servers.json：

[
  {
    "id": "my-server",
    "name": "my-server",
    "url": "http://127.0.0.1:9801/mcp"
  }
]
  • 传输协议：Streamable HTTP
  • BIT 启动后自动对每个服务器执行 initialize 握手，协商协议版本，并保存返回的 Mcp-Session-Id（后续所有请求必须携带）
  • 拒绝非 MCP 服务器（未通过 initialize 校验的端点不会接入）
  • 成功接入后，服务器上报的工具自动出现在「工具」页，AI 可直接调用

数据目录位置

应用数据目录（identifier: com.bit.hub）：

平台 路径
macOS ~/Library/Application Support/com.bit.hub/
Linux ~/.local/share/com.bit.hub/（或 XDG data dir）
Windows %APPDATA%/com.bit.hub/

工具生效

MCP 集成触发 tools-updated 事件，前端与工具注册表热更新，无需重启应用。

BIT 自身也是标准 MCP 服务器

BIT 的远程 HTTP 服务同时暴露一个标准 MCP 端点（POST /mcp，Streamable HTTP / JSON-RPC 2.0），任何标准 MCP 客户端（Claude Desktop、Cherry Studio、MCP Inspector 等）都可以接入 BIT 的全部启用工具：

  • 认证：与 OpenAI 兼容端点一致——Authorization: Bearer <Client Key> 或 ?key= 查询参数
  • 协议版本协商：支持 2024-11-05 / 2025-03-26 / 2025-06-18，客户端请求的版本在支持列表内则回显同版本，否则返回最新支持版
  • 会话管理：initialize 响应头返回 Mcp-Session-Id，后续请求必须携带（缺失 400 / 过期 404，空闲 30 分钟过期）
  • JSON-RPC batch：POST 数组按 batch 逐条处理；DELETE /mcp 显式终止会话；GET /mcp 返回 405（不提供服务器推送流）

排错

  • 服务器不可达：工具列表中不会出现该服务器的工具，检查 URL 与网络
  • 版本协商失败：查看 审计日志 中 mcp.* 相关记录
  • 会话失效（服务器重启）：BIT 会在下次调用失败后重新 initialize

中文

English

Clone this wiki locally