内容
技能路由器 MCP
技能路由器 MCP 是一个用于大量代理技能的本地只读路由器。它索引已安装的 `SKILL 文件，搜索其元数据和，报告重复定义，并向代理建议一组透明的候。
路由器不执行技能，也不做出。它返回：
- 主要技能；
- 补充技能；
- 其他可能因结果限制太小而被隐藏的候选技能；
- 调用模式（`automatic`，`manual-only`，或未指定） 匹配证据和重复路径过程中不使用 LLM、嵌入 API、遥测或网络调用 MCP 工具
- `ills 总结索引根模式、重复名称和读取- `search_skills`查找能力或任务的确定性。
- `recommend_skills` — 建议主要、补充和选技能，同时将决策权代理。
- `explain_skill` — 返回确切技能名称的元数据和重复位置。
所有工具都只读和幂等。
## 要求
- Node.js 或更新版本。
- 具有本地标准输入/输出支持的 MCP 客户端，例如 Cursor。
## 安装
```bash
npm install -g https://github.com/Agent-Nova-107/skill-router-mcp/archive/refs/heads/main.tar.gz
```
将服务器添加到 Cursor 的用户 MCP 配置中：
```json
{
"mcpServers": {
"skill-router": {
"command": "skill-router-mcp"
}
}
}
```
安装可选的代理技能：
```bash
npx skills add Agent-Nova-107/skill-router-mcp --global --agent cursor --yes
```
如果您希望 Cursor 在遇到模糊或复杂任务时自动咨询路由器，请将 `cursor/skill-routing.mdc` 复制到 `~/.cursor/rules/skill-routing.mdc`。
更改 MCP 配置后，请重启 Cursor。
## 索引位置
默认情况下，服务器会检查：
```text
~/.agents/skills/
~/.cursor/skills/
<current-directoryagents/skills/
<current/.cursor/skills/
```
SKILL_ROUTER_PATHS` 重写此列表，使用操作系统的正常路径分隔符（Windows 上为 `;`，Unix 上为 `:`）：
```powershell
$env:SKILL_ROUTER_PATHS = "C:\skills;D:\team-skills"
```
不会跟随符号链接。大于 256 KiB 的技能文件和超过八个目录的遍历将被拒绝。
## 路由模型
路由是确定的：
1. 解析 YAML 前置元数据和调用元数据。
2. 规范化英文和法文任务术语。
3. 分别为名称、描述、工作流程文本和生命周期意图评分。
4. 合并重复名称，同时暴露每个重复路径。
5. 返回一个广泛的候选池，分为主要、补充和额外部分。
分数对候选技能进行排名；它们不是概率或质量评级。
## 安全性和限制
- 工具接受任务文本和技能名称，而不是任意文件系统路径。
- 服务器只读取配置的技能根目录。
- 技能内的提示文本被视为可搜索数据，永远不会被执行。
- 关键词路由可能会错过语义关系或过高地排名通用描述。
- 推荐仅证明相关性，不证明质量、新鲜度、兼容性或安全性。
- AI 代理必须在执行前检查任务、代码库和选定的技能。
## 开发
```bash
npm ci
npm run check
npm test
npm run build
```
使用 MCP 检查器对 stdio 服务器进行烟雾测试：
```bash
npx @modelcontextprotocol/inspector node dist/index.js
```
## 许可证
MIT
