Skill Mcp Server

Skill MCP Server 🚀

スキルフォルダーを追加するだけで、あらゆる AI エージェントを専門家に変えます。

📖 これは何ですか？ • 🌟 選ぶ理由 • ✨ 特長 • 🚀 クイックスタート • 📝 スキルの作成 • 📚 ドキュメント

📖 Skill MCP Server とは？

Skill MCP Server は、Claude Skills を MCP に対応したあらゆる AI エージェントに接続する、標準的な Model Context Protocol (MCP) サーバーです。

これまで、Claude Skills は主に Anthropic の公式ツールで使われていました。AI アプリケーションが Skills に対応していない場合、独自の解析・実行ロジックを実装する必要があり、手間がかかります。このプロジェクトを使えば、設定するだけで、MCP 対応エージェントが標準の Skill ファイルを直接利用できるようになります。

---

🎬 デモ

💡 主な概念

• 🔌 MCP (Model Context Protocol)：AI の「USB インターフェース」のようなものです。AI アシスタントがこのインターフェースに対応していれば、さまざまなツールやサービスに接続できます。
• 📦 Claude Skills：AI 向けの「スキルパッケージ」のようなものです。単なるドキュメントではなく、手順（SKILL.md）、付属スクリプト（Python/JS）、参考資料が含まれています。

Skill MCP Server は、さまざまなエージェントが Skill エコシステムを利用できるようにする「変換ツール」であり、プラグアンドプレイを実現します。

🌟 Skill MCP Server を選ぶ理由

エージェントがまだ Skills に対応していない場合、このプロジェクトを使えばすばやく統合できます。

項目	標準対応エージェント（例：Claude Code）	その他のエージェント（このプロジェクトを利用）
利用のハードル	深く統合されており、通常は移植できません	ハードルが低く、標準の MCP プロトコルを使用します
開発の負担	公式実装が完了しています	コード不要で、Skill パーサーの構築も不要です
柔軟性	特定のクライアントに依存します	クロスプラットフォームで、MCP 対応のあらゆるエージェントで動作します
機能の同等性	スクリプト、リソース、ファイルストリームを完全にサポートします	動的実行とリソースアクセスを同様に利用できます

✨ 特長

• 🛠️ 高い標準準拠性：MCP プロトコルに厳密に準拠しています
• 🌍 幅広い互換性：ベンダーに依存せず、MCP 対応のすべての AI クライアントで動作します
• ⚡ コード不要の統合：Skill に標準対応していないエージェントでも、Skill エコシステムをすばやく利用できます
• 📦 完全な互換性：SKILL.md 形式と、リソースディレクトリ scripts/、references/ に対応しています
• 📂 ワークスペースの分離：--workspace パラメーターで Skill の出力ファイルの保存先を指定できます
• 🔄 ホットリロード：サーバーを再起動せずに新しいスキルを追加できます
• 🔒 セキュリティを考慮した設計：パス検証とサンドボックス化されたファイル操作に対応しています

🚀 クイックスタート

推奨：手動でインストールせずに実行できる uvx を使用してください。

📥 インストール

# Using pip
pip install skill-mcp-server

# Using uv (recommended)
uv pip install skill-mcp-server

⚙️ MCP の設定

Skill MCP Server を MCP クライアントの設定に追加してください。MCP 対応クライアントでは、すべて同じ設定形式を使用します。

uvx を使用する場合（推奨、インストール不要）：

{
  "mcpServers": {
    "skill-server": {
      "command": "uvx",
      "args": [
        "skill-mcp-server",
        "--skills-dir", "/path/to/your/skills",
        "--workspace", "/path/to/workspace"
      ]
    }
  }
}

ローカルにインストールする場合：

{
  "mcpServers": {
    "skill-server": {
      "command": "python",
      "args": [
        "-m", "skill_mcp_server",
        "--skills-dir", "/path/to/your/skills",
        "--workspace", "/path/to/workspace"
      ]
    }
  }
}

設定ファイルの場所：

• Claude Desktop：claude_desktop_config.json（場所は OS によって異なります）
• Claude Code：~/.claude.json
• その他の MCP クライアント：クライアントのドキュメントを参照してください

パラメーターの説明：

• --skills-dir：主要なパラメーターです。エージェントに使用させるすべての Skill フォルダーを含むルートディレクトリを指定します。
• --workspace：重要なパラメーターです。Skill の実行結果ファイル（コード、レポートなど）の保存先を指定します。

🛠️ 利用可能なツール（MCP ツール）

接続すると、AI エージェントは以下のツールを使用できます。

1. 🔍 list_skills：利用可能なスキルをすべて一覧表示します
2. 📚 skill：SKILL.mdから詳細な手順を取得するため、特定のスキルを読み込みます
3. 📄 skill_resource：スキルパッケージからリファレンスドキュメントやテンプレートを読み込みます
4. ▶️ skill_script：安全な環境でスキルに含まれるスクリプトを実行します
5. 📖 file_read：指定したワークスペースからファイルを読み込みます
6. ✍️ file_write：指定したワークスペースにファイルを書き込みます
7. ✏️ file_edit：ワークスペース内の既存ファイルを編集します

📝 スキルの作成

標準的なスキルの構成は次のとおりです。

my-skills/
└── deploy-helper/           # Skill folder
    ├── SKILL.md             # Core documentation (required)
    ├── scripts/             # Executable scripts
    └── references/          # Reference materials

SKILL.md の例：

---
name: deploy-helper
description: Help users deploy applications to production with one click
---

# Deploy Helper Usage Guide

When users request deployment, follow these steps:
1. Use `skill_resource` to read the deployment template.
2. Modify local configuration files.
3. Call `skill_script` to execute the deployment script.

SKILL.md の形式

---
name: my-skill
description: Brief description of what this skill does and when to use it
---

# My Skill

## Overview

Explain what this skill enables the AI to do.

## Usage

Step-by-step instructions for the AI agent...

## Available Resources

- `scripts/process_data.py` - Process input data
- `assets/report_template.md` - Output template

💼 使用例

• 📊 データ分析：エージェントがデータ分析を行えるようにします
• 📝 ドキュメント生成：エージェントが専門的なドキュメントを作成できるようにします
• 🔗 API 統合：エージェントが特定の API と連携できるようにします
• 🔍 コードレビュー：エージェントがチームの標準に従えるようにします
• 🚀 DevOps タスク：エージェントがデプロイのワークフローを自動化できるようにします

📚 ドキュメント

• 📖 はじめに
• ✨ スキルの作成
• 📋 スキル形式のリファレンス
• 📤 公開ガイド

🛠️ 開発

# Clone the repository
git clone https://github.com/ephemeraldew/skill_mcp.git
cd skill_mcp

# Install development dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Run linting
ruff check src/

🤝 貢献

貢献を歓迎します！ガイドラインについてはCONTRIBUTING.mdをご覧ください。

このプロジェクトが役に立った場合は、⭐️ Star を付けてください。

📄 ライセンス

MIT License — 詳細についてはLICENSEをご覧ください。

🔗 関連リソース

• MCP 公式ドキュメント
• Claude Skills 公式ガイド
• Agent Skills オープンスタンダード

---

_{Model Context Protocolで構築}