Skill To MCP

🚀 Skill-to-MCP

AIスキル（Claude Skillsの形式に従う）をMCPサーバーリソースに変換し、Model Context Protocolを通じてアクセス可能にします。

BioContextAIの一部 - 標準化されたMCPサーバーを通じて、自律型AIと生物医学リソースを接続するコミュニティ主導の取り組みです。このパッケージはドメインに依存せず、任意のスキルコレクションに使用できますが、生物医学研究コミュニティをサポートするために開発されました。

🚀 クイックスタート

詳細なガイドについては[ドキュメント][]を参照してください。または以下の項目にジャンプできます。

• 設定 - スキルディレクトリの設定
• 使用方法 - 3つのコアツールについて学ぶ
• スキルの作成 - 独自のスキルを構築する
• インストール - 複数のインストールオプション

クイックリンク

• ドキュメント: skill-to-mcp.readthedocs.io
• BioContextAIレジストリ: biocontext.ai/registry
• APIリファレンス: [APIドキュメント][]
• ソースコード: GitHub
• イシュートラッカー: GitHub Issues

✨ 主な機能

• 自動スキル検出: skills/ディレクトリ内のすべてのSKILL.mdファイルを再帰的に検索します。
• フロントマター解析: YAMLフロントマターからスキルのメタデータ（名前、説明）を抽出します。
• 3つのコアツール:
  • get_available_skills: 説明付きですべての利用可能なスキルをリストします。
  • get_skill_details: 特定のスキルのSKILL.mdの内容とファイルリストを返します。
  • get_skill_related_file: スキルディレクトリ内の任意のファイルを読み取ります（ディレクトリトラバーサル保護付き）。
• セキュリティ: パス検証により、スキルディレクトリ外へのアクセスを防止します。

📦 インストール

システムにPython 3.11以上がインストールされている必要があります。Pythonがインストールされていない場合は、uvのインストールをおすすめします。

skill-to-mcpをインストールするには、いくつかの代替オプションがあります。

1. uvxを使用してすぐに実行する（SKILLS_DIR環境変数が必要）:

SKILLS_DIR=/path/to/skills uvx skill_to_mcp

またはコマンドラインオプションを使用する:

uvx skill_to_mcp --skills-dir /path/to/skills

2. mcp.json標準をサポートするさまざまなMCPクライアントに含める:

{
  "mcpServers": {
    "skill-to-mcp": {
      "command": "uvx",
      "args": ["skill_to_mcp", "--skills-dir", "/path/to/your/skills"],
      "env": {
        "UV_PYTHON": "3.12"
      }
    }
  }
}

3. pipを通じてインストールする:

pip install --user skill_to_mcp

4. 最新の開発バージョンをインストールする:

pip install git+https://github.com/biocontext-ai/skill-to-mcp.git@main

💻 使用例

基本的な使用法

# ここに基本的な使用法のコード例があれば表示されますが、元のREADMEには具体的な基本使用法のコード例がないため省略します。

高度な使用法

# ここに高度な使用法のコード例があれば表示されますが、元のREADMEには具体的な高度使用法のコード例がないため省略します。

設定例

Claude Desktopの設定

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "biomedical-skills": {
      "command": "uvx",
      "args": [
        "skill_to_mcp",
        "--skills-dir",
        "/Users/yourname/biomedical-skills"
      ],
      "env": {
        "UV_PYTHON": "3.12"
      }
    }
  }
}

複数のスキルコレクション

異なるスキルディレクトリで複数のインスタンスを実行できます。

{
  "mcpServers": {
    "biomedical-skills": {
      "command": "uvx",
      "args": ["skill_to_mcp", "--skills-dir", "/path/to/biomedical-skills"]
    },
    "data-science-skills": {
      "command": "uvx",
      "args": ["skill_to_mcp", "--skills-dir", "/path/to/data-science-skills"]
    }
  }
}

📚 ドキュメント

設定

MCPサーバーにはスキルディレクトリを指定する必要があります。これにより、以下のことが可能になります。

• パッケージをスキルとは別にインストールする
• パッケージを変更せずにスキルを編集する
• 異なるプロジェクトに異なるスキルコレクションを使用する

スキルディレクトリは以下のいずれかの方法で設定します。

• コマンドラインオプション: --skills-dir /path/to/skills
• 環境変数: SKILLS_DIR=/path/to/skills

MCPクライアントの設定例

{
  "mcpServers": {
    "skill-to-mcp": {
      "command": "uvx",
      "args": ["skill_to_mcp", "--skills-dir", "/path/to/your/skills"],
      "env": {
        "UV_PYTHON": "3.12"
      }
    }
  }
}

または環境変数を使用する:

{
  "mcpServers": {
    "skill-to-mcp": {
      "command": "uvx",
      "args": ["skill_to_mcp"],
      "env": {
        "UV_PYTHON": "3.12",
        "SKILLS_DIR": "/path/to/your/skills"
      }
    }
  }
}

使用方法

MCPクライアントで設定した後、サーバーは3つのツールを提供します。

get_available_skills

メタデータ付きのすべての利用可能なスキルのリストを返します。

[
  {
    "name": "single-cell-rna-qc",
    "description": "Performs quality control on single-cell RNA-seq data...",
    "path": "/path/to/skills/single-cell-rna-qc"
  }
]

get_skill_details

特定のスキルのSKILL.mdの完全な内容とファイルリストを返します。

{
  "skill_content": "---\nname: single-cell-rna-qc\n...",
  "files": ["SKILL.md", "scripts/qc_analysis.py", "references/guidelines.md"]
}

return_typeパラメーターは返されるデータを制御します。

• "content": SKILL.mdの内容のみをテキストとして返します。
• "file_path": SKILL.mdの絶対パスのみを返します。
• "both" (デフォルト): 内容とファイルパスの両方を辞書形式で返します。

get_skill_related_file

スキルディレクトリ内の特定のファイルを読み取ります。

get_skill_related_file(
    skill_name="single-cell-rna-qc",
    relative_path="scripts/qc_analysis.py",
    return_type="content"  # "content", "file_path", or "both" (default)
)

スキルの作成

スキルは設定したスキルディレクトリに配置する必要があります。各スキルは以下の条件を満たす必要があります。

1. 独自のサブディレクトリを持つ
2. YAMLフロントマター付きのSKILL.mdファイルを含む
3. フロントマターの形式に従う

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

# Skill Content

Instructions and documentation go here...

スキルの命名要件

• 小文字のアルファベット、数字、ハイフンのみを使用する
• 最大64文字
• XMLタグや予約語を使用しない

完全な参照については、含まれている例のskills/single-cell-rna-qc/SKILL.mdを参照してください。

スキルディレクトリの構造例

my-skills/
├── skill-1/
│   ├── SKILL.md
│   ├── scripts/
│   └── references/
├── skill-2/
│   ├── SKILL.md
│   └── data/
└── skill-3/
    └── SKILL.md

デプロイオプション

ローカル開発

開発とテスト用です。

# uvxを使用する（推奨） 
SKILLS_DIR=/path/to/skills uvx skill_to_mcp 

# pipを使用する 
pip install skill_to_mcp 
skill_to_mcp --skills-dir /path/to/skills 

本番環境のデプロイ

HTTPトランスポートを使用する本番環境用です。

export MCP_ENVIRONMENT=PRODUCTION 
export SKILLS_DIR=/path/to/skills 
export MCP_TRANSPORT=http 
export MCP_PORT=8000 

skill_to_mcp 

Dockerデプロイ

Dockerfileを作成します。

FROM python:3.12-slim 

WORKDIR /app 

RUN pip install skill_to_mcp 

COPY skills /app/skills 

ENV SKILLS_DIR=/app/skills 
ENV MCP_TRANSPORT=http 
ENV MCP_PORT=8000 

CMD ["skill_to_mcp"] 

ビルドして実行します。

docker build -t skill-to-mcp . 
docker run -p 8000:8000 skill-to-mcp 

🔧 技術詳細

このMCPサーバーは、Claude Skillsをリソースとして公開し、LLMアプリケーションがModel Context Protocolを通じてアクセスできるようにします。スキルは、YAMLフロントマター付きのSKILL.mdファイルと、スクリプト、リファレンス、例などのサポートファイルを含む自己完結型のディレクトリです。

📄 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

注: このソフトウェアはオープンソースですが、個々のスキルには独自のライセンスがある場合があります。ユーザーは、使用または配布するスキルのライセンスに準拠する責任があります。