概要

mcp-to-skill-converterは、MCP（Multi-Tool/Managed Capability Provider）サーバーで定義された多数のツールを、AnthropicのClaudeが利用する「Skill」形式に変換するためのユーティリティです。多くのMCP実装では全ツール定義を初期コンテキストに読み込むため、ツール数が増えると数万トークンを消費してしまいます。本リポジトリは「プログレッシブ・ディスクロージャ（段階的開示）」パターンを採用し、起動時には最小限のメタデータのみを渡しておき、ユーザーやモデルがそのツールを実際に必要としたタイミングで詳細（完全な指示セットやパラメータ定義）を提供することで、トークン使用量を大幅に削減します。付属の例ファイルと変換スクリプトにより、既存のMCPサーバーを短時間でClaude Skill化できます。

リポジトリの統計情報

スター数: 12
フォーク数: 1
ウォッチャー数: 12
コミット数: 4
ファイル数: 3
メインの言語: Python

主な特徴

プログレッシブ・ディスクロージャを適用し、起動時のコンテキストを最小化（約100トークン）。
ツールが必要になった時点でのみ完全な指示や定義を開示（利用時に約5kトークン想定）。
実行フェーズではモデル側に大きなトークン負荷をかけず、外部でコマンド実行する設計（実行時のトークン負荷をほぼゼロに）。
シンプルなPythonスクリプトで既存MCP定義（JSON等）を変換可能。例ファイルを同梱しており導入が容易。

技術的なポイント

mcp-to-skill-converterの核心は「情報をいつ渡すか」を制御する設計哲学にあります。従来のアプローチでは、各ツールの詳細（説明、パラメータ、使用例など）をセッション開始時にすべてClaudeに渡すため、ツール数が増えると数万トークンが占有され、実質的な会話や推論に使えるコンテキストが枯渇します。本リポジトリはplaywright-skillから着想を得たプログレッシブ・ディスクロージャを導入し、以下のようなフローでトークン効率を高めます。

起動（Startup）：Skillのメタ情報や最小限の能力表現のみをClaudeに提示し、初期トークン消費を約100トークンに抑える。これにより多数のSkillを同時に扱っても初期負担が小さい。
利用時（When used）：ユーザーやモデルが特定の機能を要求した際に、そのツールの完全な指示セット（詳細なパラメータ仕様や実行手順）を動的に注入する。ここで5k程度のトークンを投入するが、必要な場面でのみ行われるため全体としての消費は小さくなる。
実行（Executing）：実際の処理はMCPサーバー側で行い、実行ログや結果のみを返すことでモデル側のコンテキスト負荷を最小化する。Designとしてはモデルは「どのツールを呼ぶか」を指示し、詳細な実行は外部で完結する設計。

技術的には、mcp_to_skill.pyがMCP定義（例: example-github-mcp.json）を読み取り、Claudeが期待するSkillメタデータと段階的開示用のハンドリングを生成する処理を担っていると想定されます。変換時には、起動用の軽量メタデータと、必要時に差し込むためのフル説明を分離して出力することで、ランタイムでのオンデマンド提供を可能にしています。Python実装の利点として、既存のJSON/YAMLベースのMCP定義との親和性が高く、CIやデプロイパイプラインに組み込みやすい点が挙げられます。

セキュリティや運用面では、動的に開示されるツール説明の管理やアクセス制御、ログと実行結果の取り扱いが重要です。本リポジトリ自体は変換を行うツール群を提供するもので、実際のMCPサーバーやClaudeとの統合時には認証・権限制御・監査ログ等の実装を併用することが望ましいでしょう。また、段階的開示による遅延（必要時に追加の情報を注入する分の待ち時間）や、モデルがどのタイミングで詳細を要求するかの設計（プロンプト設計やインタラクション設計）も実運用での調整点となります。

プロジェクトの構成

主要なファイルとディレクトリ：

README.md: file
example-github-mcp.json: file
mcp_to_skill.py: file

（example-github-mcp.json はサンプルのMCP定義、mcp_to_skill.py はその定義をClaude用Skillに変換するためのスクリプトと推定されます。）

まとめ

MCPの多ツール定義を効率的にClaude Skill化し、トークン消費を大幅に削減できる実用的なユーティリティです。

リポジトリ情報：

名前: -mcp-to-skill-converter
説明: Convert any MCP server into a Claude Skill with 90% context savings
スター数: 12
言語: Python
URL: https://github.com/GBSOSS/-mcp-to-skill-converter
オーナー: GBSOSS
アバター: https://avatars.githubusercontent.com/u/240244068?v=4

READMEの抜粋：

mcp-to-skill-converter

Convert any MCP server into a Claude Skill with 90% context savings.

Why This Exists

MCP servers are great but load all tool definitions into context at startup. With 20+ tools, that’s 30-50k tokens gone before Claude does any work.

This converter applies the “progressive disclosure” pattern (inspired by playwright-skill) to any MCP server:

Startup: ~100 tokens (just metadata)
When used: ~5k tokens (full instructions)
Executing: 0 tokens (runs ex…

MCPをClaude Skillに変換するコンバータ