DBAPI MCP 多端点发布

多端点是 DBAPI MCP 的一个重要功能,它可以实现多个 AI 端点,每个端点只暴露一部分 API。

什么是多端点?

MCP 多端点是指在一个 MCP Server 上创建多个独立的路径,每个路径只暴露一部分 API 工具给 AI 客户端。

举个例子:你有一个 API 系统,里面既有订单接口又有商品接口。用传统单端点,AI 客户端连接后能看到所有接口。用多端点,你可以创建两个路径:

/order/mcp   → 只暴露订单相关 API
/product/mcp  → 只暴露商品相关 API

每个 AI 客户端按需连接,看到的只是自己需要的工具集。

设计初衷

AI 模型在与 MCP 工具交互时,会将所有可用的工具描述全部注入上下文。当发布的 API 越来越多,工具列表越来越长,会带来两个严重问题:

  1. Token 消耗激增 — 每个工具的名称、描述、参数 schema 都占用上下文 token,直接增加调用成本
  2. AI 准确性下降 — 无关工具的干扰使模型难以准确选择和调用正确的工具,尤其在工具数量超过几十个时,准确率显著下降

DBAPI 的 MCP 多端点特性正是为了解决这个问题而设计:将 API 按业务维度分组到不同的 MCP 端点,每个 AI 客户端只连接它需要的端点,上下文里只包含相关的工具


对比

传统单端点 DBAPI 多端点
上下文大小 所有 API 全部注入,极易撑爆 只注入当前端点下的 API
Token 成本 高(无关工具也在消耗) 低(按需加载)
AI 准确率 工具越多准确率越低 工具少而精,选择更准
多团队使用 所有 API 混在一起 每个团队独立的端点

如何使用?

1. 创建端点

进入 设置 → MCP 端点,点击创建端点。路径必须以 / 开头、以 /mcp 结尾,例如 /sales/mcp。系统预置默认端点 /mcp(不可删除)。

2. 发布 API 到端点

在 API 列表页面,点击 API 的 MCP 图标按钮,弹出发布对话框。勾选要发布到的端点(可多选),一个 API 可同时发布到多个端点。不勾选任何端点即为取消发布。

3. AI 客户端连接

MCP Server 启动后监听端口(默认 8526),每个端点对应独立路径:

# 连接默认端点,看到所有发布的 API
mcp connect http://your-server:8526/mcp

# 连接销售端点,只看到销售相关 API
mcp connect http://your-server:8526/sales/mcp

# 连接 HR 端点,只看到人事相关 API
mcp connect http://your-server:8526/hr/mcp

端点的新增和删除在后台自动同步,无需重启 MCP 服务。


最佳实践

  • 按业务域划分端点 — 每个端点对应一个业务模块,如订单、支付、库存,确保每个端点的工具数量可控
  • 控制端点数量 — 根据实际团队和业务划分,避免过多
  • 配合权限使用 — 建议配合 DBAPI 的 IP 白名单和 Token 认证
Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐