MCP Server Dataset Builder

MCP サーバー データセットビルダー

Model Context Protocol（MCP）サーバーのデータセットを構築・管理するための包括的なツールです。このツールは、複数のソースから MCP サーバーに関する情報を自動的に収集、分類、更新します。

概要

MCP サーバー データセットビルダーは、次の目的で設計されています。

1. awesome-mcp-servers リポジトリから MCP サーバーの情報を抽出する
2. GitHub で追加の MCP サーバーリポジトリを検索する
3. 2 つのソースからのデータを統合し、重複を削除する
4. 各サーバーの包括的な情報を含む CSV ファイルを毎日生成する

特長

• 2 つのデータソース：キュレーションされたリストと GitHub 検索のデータを統合します
• 自動分類：リポジトリの内容に基づいてカテゴリを割り当てます
• 技術スタックの検出：プログラミング言語とフレームワークを特定します
• 絵文字タグ付け：素早く識別できるよう、視覚的なインジケーターを追加します
• 毎日の更新：データセットを最新の状態に保つため、自動的に実行されます
• データの永続化：新しいエントリを追加しながら、過去のデータを維持します

データセットの構造

生成される CSV ファイルには、次のフィールドが含まれます。

フィールド	説明
name	リポジトリ名
description	リポジトリの説明
html_url	リポジトリの URL
stars	GitHub のスター数
forks	GitHub のフォーク数
keywords	カンマ区切りのキーワード一覧
category	主なカテゴリ（例：フレームワーク、ユーティリティ、クライアント）
techstack	使用されている技術のカンマ区切り一覧
emojis	素早く識別するための視覚的なインジケーター

使用方法

毎日の自動更新

データセットは GitHub Actions によって毎日自動的に更新されます。手動での操作は不要です。

手動での実行

GitHub Actions タブからワークフローを手動で実行できます。

1. リポジトリの「Actions」タブを開きます
2. 「Unified MCP Servers Extraction」を選択します
3. 「Run workflow」をクリックします
4. 必要に応じて、次の項目をカスタマイズします。
   • GitHub 検索のキーワード
   • スター数とフォーク数の最小しきい値
   • 実行する抽出方法

ローカルでの開発

スクリプトをローカルで実行するには、次の手順に従います。

# Install dependencies
pip install -r requirements.txt

# Run README extraction
python extract_mcp_servers.py

# Run GitHub search
python daily.py

環境変数

動作をカスタマイズするには、次の環境変数を使用できます。

変数	説明	デフォルト
GITHUB_TOKEN	認証用の GitHub API トークン	-
KEYWORDS_ENV	検索キーワードのカンマ区切り一覧	MCP 関連のキーワード
MIN_STARS	リポジトリの最小スター数	10
MIN_FORKS	リポジトリの最小フォーク数	5

データソース

1. Awesome MCP Servers リポジトリ

このツールは、カテゴリ別に整理された MCP サーバーのキュレーションリストを含む awesome-mcp-servers リポジトリからデータを抽出します。

2. GitHub 検索

このツールは、MCP 関連のキーワードに一致するリポジトリを GitHub で検索し、エコシステムを幅広くカバーします。

分類システム

リポジトリは、内容と用途に基づいて分類されます。

• フレームワーク：MCP サーバーの中核的な実装
• ユーティリティ：ヘルパーツールとユーティリティ
• クライアント：クライアントライブラリとアプリケーション
• チュートリアル：学習リソースとサンプル
• データベース：データベースとの統合
• API：API の実装
• ストレージ：ストレージソリューション
• AI：AI および LLM との統合
• チャット：チャットとメッセージング機能
• 検索：検索機能

技術スタックの検出

このツールは、次の技術を特定します。

• 言語：Python、TypeScript、Go、Rust、Java、C#
• フレームワーク：FastAPI、Langchain、Spring
• プロトコル：SSE、WebSocket、HTTP
• デプロイ：クラウド、ローカル、Docker
• プラットフォーム：iOS、Windows、Linux

コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。

ライセンス

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