Skill Router MCP

🚀 🧠 技能路由MCP服务器

这是一个轻量级的MCP服务器，能让AI智能体按需访问专业技能。它由 FunctionGemma 提供支持，可实现智能且经济高效的技能匹配，避免在大语言模型（LLM）的上下文中塞入过多内容，让模型在需要时获取所需信息。

🚀 快速开始

本项目旨在解决大语言模型上下文窗口宝贵且成本高昂的问题。借助 FunctionGemma 模型，可实现技能的按需加载，避免将所有指令都塞进系统提示中。以下是使用本项目的基本步骤：

1. 安装Ollama。
2. 拉取FunctionGemma模型。
3. 启动Ollama服务器。
4. 构建技能路由。

✨ 主要特性

• 按需访问技能：将技能单独存储在简单的Markdown文件中，让智能体按需搜索相关技能，仅在需要时加载，节省成本。
• 智能技能匹配：由 FunctionGemma 处理语义匹配，即使用户的表述与技能名称不完全匹配，也能找到合适的技能。
• 轻量级高效：基于轻量级的 FunctionGemma 模型，可在本地通过Ollama运行，资源占用少，速度快。

📦 安装指南

1. 安装Ollama

首先，根据你的平台安装 Ollama：

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Windows: 从 https://ollama.com/download 下载

2. 拉取FunctionGemma模型

ollama pull functiongemma

📖 模型详情：ollama.com/library/functiongemma

3. 启动Ollama服务器

ollama serve

注意：在启动技能路由MCP服务器之前，必须先运行Ollama。

4. 构建技能路由

cargo build --release

💻 使用示例

基础用法

# 默认技能路径 (./skills)
./target/release/skill-router-mcp

# 自定义技能路径
./target/release/skill-router-mcp -s /path/to/skills

🔧 技术细节

工作原理

用户: "创建一个关于猫的PowerPoint演示文稿"
    ↓
智能体: search_skill("PowerPoint演示文稿幻灯片")
    ↓
FunctionGemma: 匹配 → "pptx-generator" 技能
    ↓
智能体: 接收完整指令和脚本
    ↓
智能体: 完美执行任务 ✨

FunctionGemma 负责语义匹配，即使用户的表述与技能名称不完全匹配，也能找到合适的技能。

核心模型：FunctionGemma

本MCP服务器由 FunctionGemma 提供支持，它是谷歌专门用于函数调用和工具使用的模型，在理解用户意图并将其与正确的工具/技能匹配方面表现出色。

选择FunctionGemma的原因

• 专为函数调用设计：不是通用大语言模型的附加功能，而是专门为函数调用构建。
• 轻量级：可通过Ollama在本地运行，资源占用极少。
• 快速：针对快速语义匹配进行了优化。
• 经济高效：无需API成本，完全在本地机器上运行。

📚 详细文档

MCP配置

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "skill-router": {
      "command": "/path/to/skill-router",
      "args": ["-s", "/path/to/skills"]
    }
  }
}

Windsurf/Cursor (MCP设置)

{
  "skill-router": {
    "command": "/path/to/skill-router",
    "args": ["-s", "/path/to/skills"]
  }
}

技能格式

skills/
├── pptx-generator/
│   ├── SKILL.md          # 说明文档
│   └── create_pptx.py    # 可选脚本
└── pdf-report/
    └── SKILL.md

SKILL.md 示例：

---
name: pptx-generator
description: 从Markdown创建PowerPoint演示文稿
---

# 如何创建PPTX

1. 使用 `create_pptx.py` 脚本
2. 将Markdown内容作为输入
3. ...

智能体使用规则

服务器指导智能体：

1. 在搜索前用技能类别和技术增强查询。
2. 尝试最多3次不同的查询变体。
3. 找到技能后严格遵循技能说明。

这样可以在保持上下文简洁的同时，最大化匹配成功率。

测试方法

npx @modelcontextprotocol/inspector ./target/release/skill-router-mcp

技能生态系统

官方技能（Anthropic）

可浏览并使用来自 anthropics/skills 的官方技能：

社区技能

可在 awesome-claude-skills 探索社区贡献的技能：

• obra/superpowers — 20多种经过实战检验的技能（TDD、调试、协作）
• ios-simulator-skill — iOS模拟器集成
• playwright-skill — 浏览器自动化
• claude-d3js-skill — D3.js可视化
• claude-scientific-skills — 科学计算
• Skill_Seekers — 将文档转换为技能

智能体技能规范

智能体技能 规范为技能提供了标准化格式：

• 领域专业知识封装
• 新功能（演示文稿、MCP服务器、数据分析）
• 可重复的工作流程
• 跨平台互操作性

💡 使用建议：从这些仓库下载技能到你的 skills/ 文件夹，技能路由将自动找到它们！

📄 许可证

本项目采用MIT许可证，你可以自由使用！🎉