> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcphub.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能路由

> 使用向量语义搜索进行智能工具发现。

智能路由是 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 行数、去重服务器数、维度）、按模型/按服务器的统计、同步新鲜度以及索引覆盖率。

```bash theme={null}
curl http://localhost:3000/api/smart-routing/performance \
  -H "Authorization: Bearer YOUR_JWT_OR_BEARER_KEY"
```

### 重新索引

全量强制重建向量索引：先清空 `vector_embeddings`，再对全部已启用服务器重新生成嵌入。同步执行并返回汇总；重建进度会通过 SSE `embedding-sync-progress` 事件实时推送。

需要**个人凭据**（`credentialTemplate`）的服务器不会参与全局连接，因此会以已绑定凭据的用户身份（服务器所有者优先）建立连接，并把这些用户可见工具的**并集**写入索引；没有任何用户绑定凭据的服务器会被跳过，并在响应的 `results` 中给出原因。

同一时间只允许一次重建：若已有重建在执行，新的调用会收到 `409 A reindex pass is already running`。`GET /api/smart-routing/performance` 的返回中通过 `reindexing` 暴露同一状态，前端可据此在执行期间禁用按钮。

```bash theme={null}
curl -X POST http://localhost:3000/api/smart-routing/reindex \
  -H "Authorization: Bearer YOUR_JWT_OR_BEARER_KEY"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.