Skip to main content
智能路由是 MCPHub 的智能工具发现系统，它使用向量语义搜索来自动为任何给定任务找到最相关的工具。

​
HTTP 端点

  • 端点: http://localhost:3000/mcp/$smart
  • 方法: POST

​
SSE 端点 (已弃用)

  • 端点: http://localhost:3000/sse/$smart
  • 方法: GET

​
工作原理

  1. 工具索引: 所有 MCP 工具都会自动转换为向量嵌入并存储在带有 pgvector 的 PostgreSQL 中。
  2. 语义搜索: 用户查询被转换为向量，并使用余弦相似度与工具嵌入进行匹配。
  3. 智能过滤: 动态阈值可确保相关结果而无噪音。
  4. 精确执行: 找到的工具可以通过适当的参数验证直接执行。

​
设置要求

  • 带有 pgvector 扩展的 PostgreSQL
  • OpenAI API 密钥（或兼容的嵌入服务）
  • 在 MCPHub 设置中启用智能路由

​
诊断与维护 API

以下管理端点位于已认证的 Dashboard API 下，与其它 /api/* 路由一样，需要有效的 Dashboard 会话（JWT）或系统级 All-Access Bearer Key（Authorization: Bearer mcphub_...）。两个端点还额外仅限管理员：已认证但非管理员的身份会收到 403 Admin privileges required。

​
索引状态与性能

返回智能路由配置、数据库连接状态、向量库规模（tool/server 行数、去重服务器数、维度）、按模型/按服务器的统计、同步新鲜度以及索引覆盖率。

​
重新索引

全量强制重建向量索引：先清空 vector_embeddings，再对全部已启用服务器重新生成嵌入。同步执行并返回汇总；重建进度会通过 SSE embedding-sync-progress 事件实时推送。 需要个人凭据（credentialTemplate）的服务器不会参与全局连接，因此会以已绑定凭据的用户身份（服务器所有者优先）建立连接，并把这些用户可见工具的并集写入索引；没有任何用户绑定凭据的服务器会被跳过，并在响应的 results 中给出原因。 同一时间只允许一次重建：若已有重建在执行，新的调用会收到 409 A reindex pass is already running。GET /api/smart-routing/performance 的返回中通过 reindexing 暴露同一状态，前端可据此在执行期间禁用按钮。