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許可證，你可以自由使用！🎉