Skill Router MCP

🚀 🧠 Skill Router MCP Server

LLMのコンテキストに全ての情報を詰め込むのをやめましょう。必要なときに必要な情報を取得できるようにしましょう。

この軽量なMCPサーバーは、AIエージェントが必要に応じて専門的なスキルにアクセスできるようにします。FunctionGemmaによるスマートで費用対効果の高いスキルマッチングをサポートしています。

🚀 クイックスタート

このセクションでは、Skill Router MCP Serverの概要、なぜ必要なのか、そしてどのように動作するかを説明します。

概要

このサーバーは、AIエージェントが必要に応じて専門的なスキルにアクセスできるようにする軽量なMCPサーバーです。FunctionGemmaを使用して、スマートで費用対効果の高いスキルマッチングを行います。

なぜ必要なのか

LLMのコンテキストウィンドウは貴重で（そして高価で）すべての可能な命令をシステムプロンプトに詰め込む代わりに、以下のようにします。

1. スキルを簡単なMarkdownファイルに個別に保存します。
2. エージェントに関連するスキルを必要に応じて検索させます。
3. 使用したものにのみ料金を支払います。必要なときにのみスキルが読み込まれます。

これは、AI命令の遅延読み込みのようなものです。🚀

動作原理

ユーザー: "猫に関するPowerPointプレゼンテーションを作成して"
    ↓
エージェント: search_skill("PowerPointプレゼンテーションのスライド")
    ↓
FunctionGemma: 一致するスキル → "pptx-generator"スキル
    ↓
エージェント: 完全な命令とスクリプトを受け取る
    ↓
エージェント: タスクを完璧に実行する ✨

FunctionGemmaは、ユーザーの言葉がスキル名と正確に一致しない場合でも、適切なスキルを見つけるセマンティックマッチングを処理します。

✨ 主な機能

• FunctionGemmaを活用：GoogleのFunctionGemmaモデルを使用して、関数呼び出しとツールの使用に特化したスキルマッチングを行います。
• コンテキストの効率化：LLMのコンテキストウィンドウを節約し、必要なときに必要なスキルを取得できるようにします。
• 軽量かつ高速：Ollamaを介してローカルで実行され、最小限のリソースで高速なセマンティックマッチングを行います。
• 費用対効果が高い：APIコストがかからず、すべて自前のマシンで実行できます。

📦 インストール

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

⚠️ 重要提示

Skill Router MCPサーバーを起動する前に、Ollamaを実行しておく必要があります。

4. Skill Routerのビルド

cargo build --release

💻 使用例

基本的な使用法

# デフォルトのスキルパス (./skills)
./target/release/skill-router-mcp

# カスタムのスキルパス
./target/release/skill-router-mcp -s /path/to/skills

📚 ドキュメント

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プレゼンテーションを作成する
---

# PowerPointプレゼンテーションの作成方法

1. `create_pptx.py`スクリプトを使用する
2. Markdownの内容を入力として渡す
3. ...

エージェントの使用ルール

サーバーはエージェントに以下のことを指示します。

1. 検索する前に、スキルのカテゴリと技術でクエリを強化する。
2. 異なるクエリのバリエーションで最大3回試行する。
3. 見つかったスキルの命令に正確に従う。

これにより、コンテキストを最小限に抑えながら、マッチングの成功率を最大化します。

テスト方法

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

スキルエコシステム

すでに、Anthropicやコミュニティから豊富なスキルが提供されています！

公式スキル (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 — ドキュメントをスキルに変換

エージェントスキル仕様

Agent Skills 仕様は、スキルの標準化された形式を提供します。

• ドメインの専門知識のパッケージング
• 新しい機能 (プレゼンテーション、MCPサーバー、データ分析)
• 繰り返し可能なワークフロー
• クロスプラットフォームの相互運用性

💡 使用建议

これらのリポジトリからスキルをskills/フォルダにダウンロードし、Skill Routerが自動的に見つけるようにしましょう！

🔧 技術詳細

このMCPサーバーは、Googleの関数呼び出しとツール使用に特化したモデルである**FunctionGemma** を使用しています。FunctionGemmaは、ユーザーの意図を理解し、それを適切なツール/スキルにマッチングするのに優れています。

なぜFunctionGemmaを選んだのか？

• 関数呼び出しに特化：一般的なLLMが後からツールを使用するのではなく、関数呼び出しに特化して設計されています。
• 軽量：Ollamaを介してローカルで実行され、最小限のリソースで動作します。
• 高速：迅速なセマンティックマッチングに最適化されています。
• 費用対効果が高い：APIコストがかからず、すべて自前のマシンで実行できます。

📄 ライセンス

MITライセンスです。自由に利用してください！ 🎉