Mcp Mcp

MCP-MCP：メタ MCP サーバー

MCP-MCP は、Model Context Protocol（MCP） のツール発見と提供を担うメタ MCP サーバーです。AI アシスタントが現在利用できない機能を必要とするとき、複数の厳選されたソースから集約した1,000を超えるサーバーの包括的なデータベースを検索し、適切な MCP サーバーを提案するよう MCP-MCP に依頼できます。

MCP サーバーの「電話帳」のようなものと考えてください。ほかのすべてのツールを見つけるためのツールです。

🗃️ 2,874以上の MCP サーバーを利用可能

MCP-MCP では、以下を含む複数の厳選されたソースから集約した包括的なデータベースを利用できます。

• 公式 MCP サーバー（modelcontextprotocol/servers）
• コミュニティのコレクション（Punkpeye と Appcypher の awesome リスト）
• インテリジェントな重複排除により、ソース間の重複を防止

コミュニティの最新サーバーを反映するため、データベースは3時間ごとに自動更新されます。

開発の動機

エージェントにはツールが必要です

• エージェントは必要なものを把握しています：AI アシスタントは「ドメインの空き状況を確認する」や「天気データを取得する」といった要件を明確に伝えられます
• ウェブ検索だけでは不十分なことがあります：一般的な検索結果では、リアルタイムデータを得られないことがあります
• CLI ツールにはセットアップが必要です：多くのツールは複雑なインストール、設定、API キーを必要とします。エージェントはタスクを完了するたびに、このセットアップを繰り返さなければなりません
• MCP サーバーは分散しています：優れたツールがあっても、見つけるには GitHub、フォーラム、ドキュメントを手作業で調べる必要があります

エージェントやユーザーにツールを探させるのではなく、ツールを届けてみませんか？

クイックスタート

Claude Desktop の設定

Claude Desktop の設定ファイルに MCP-MCP を追加します。

設定ファイルの場所：

• macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

設定：

{
  "mcpServers": {
    "mcp-mcp": {
      "command": "uvx",
      "args": ["mcp-mcp"]
    }
  }
}

pipx を使う場合：

{
  "mcpServers": {
    "mcp-mcp": {
      "command": "mcp-mcp"
    }
  }
}

Claude Code の設定

Claude Code の設定ファイルに MCP-MCP を追加します。

claude mcp add mcp-mcp uvx mcp-mcp

使用例

設定が完了したら、自然言語で Claude Desktop に MCP サーバーの検索を依頼できます。

• 「天気データ用の MCP サーバーを探してください」
• 「ドメインの空き状況を確認するサーバーが必要です」
• 「株式市場データに関連する MCP サーバーを検索してください」
• 「ウェブスクレイピングに利用できる MCP サーバーはありますか？」

開発

前提条件

• Python 3.13+
• uv パッケージマネージャー
• direnv（任意。環境を自動設定する場合）
• just（任意。便利な開発コマンドを使う場合）

セットアップ

# Clone the repository
git clone https://github.com/your-username/mcp-mcp.git
cd mcp-mcp

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run the server
uv run main.py

uvx 経由でインストール（テスト用）

インストールしたパッケージをテストするには：

uvx mcp-mcp

これにより、uvx 経由で MCP-MCP サーバーを直接インストールして実行します。

開発コマンド（justfile を使用）

このプロジェクトには、一般的な開発タスク用の justfile が含まれています。

# List all available commands
just help

# Development with auto-reload
just dev      # STDIO mode with file watching
just dev-http # HTTP mode with file watching

# Running without auto-reload
just run-stdio # STDIO mode
just run-http  # HTTP mode

# Testing
just test             # Unit tests only
just test-integration # Include GitHub integration tests

# Building and publishing
just build           # Build package
just publish-test    # Publish to Test PyPI
just publish-prod    # Publish to Production PyPI

# Utilities
just version # Show version
just clean   # Clean build artifacts

開発モード

開発とテストには、HTTP トランスポートを使用してください（Ctrl+C で簡単に停止できます）。

# HTTP mode (accessible at http://localhost:8000)
uv run main.py --http
# OR with justfile:
just run-http

# With auto-reload during development
just dev-http

# Custom host/port
uv run main.py --http --host 0.0.0.0 --port 3000

# STDIO mode (for MCP clients like Claude Desktop)
uv run main.py  # Note: To stop STDIO mode, use Ctrl+D (EOF), not Ctrl+C
# OR with justfile:
just run-stdio

# With auto-reload during development
just dev

ビルド

# Build package
uv build
# OR with justfile:
just build

# Test local installation
uvx --from ./dist/mcp_mcp-0.1.0-py3-none-any.whl mcp-mcp

コマンドラインオプション

mcp-mcp --help

オプション	説明	デフォルト
--transport {stdio,http}	トランスポート方式	stdio
--http	HTTP トランスポートを使用します	-
--host HOST	HTTP トランスポートのホスト	localhost
--port PORT	HTTP トランスポートのポート	8000

テスト

# Run all tests (unit + integration)
uv run pytest
# OR with justfile:
just test

# Run only unit tests (fast, no network)
uv run pytest db/ -v
# OR with justfile:
just test-unit

# Run only integration/e2e tests
uv run pytest tests/ -v
# OR with justfile:
just test-integration

# Run GitHub integration tests (optional, requires network)
MCP_MCP_TEST_GITHUB_INTEGRATION=1 uv run pytest tests/
# OR with justfile:
just test-integration-github

# Run all tests including GitHub integration
MCP_MCP_TEST_GITHUB_INTEGRATION=1 uv run pytest
# OR with justfile:
just test-all

# Run with coverage
uv run pytest --cov=db

テスト構成：

• ユニットテスト：テスト対象のコードと同じ db/ 内に配置されています（Go 形式）
• 統合テスト／E2E テスト：tests/ ディレクトリ内に配置されています

統合テスト：MCP_MCP_TEST_GITHUB_INTEGRATION=1 を設定すると、実際の GitHub ダウンロードをテストし、初回ユーザーのオンボーディング体験全体を検証できます。これらのテストでは、ユーザーが 2,874 以上のサーバーを 5 秒未満で起動できることを確認します。

ロードマップ

現在の状況：MVP 完了 ✅

• ✅ 複数のソースからの検出（厳選された 3 つのソース、重複のない 2,874 以上のサーバー）
• ✅ サブ秒の応答を実現する、事前計算済み埋め込みを使用したセマンティック検索
• ✅ 自動リリースによる uvx/pipx 経由の本番環境向け配布
• ✅ オリジン検証ミドルウェアによるセキュリティ強化
• ✅ 包括的なテストカバレッジ（65 件以上のテスト）
• ✅ 完全なドキュメントと開発ワークフロー

今後の機能強化（MVP 以降）

• サーバーの自動コンテナ化のための Docker 統合
• サーバーをシームレスに実行するための MCP プロトコルプロキシ
• ライブサーバー検出のための GitHub API 統合
• サーバーのライフサイクル管理とクリーンアップ
• プライベートレジストリのサポート
• 依存関係の解決
• パフォーマンス監視
• サーバー管理用 Web UI

コントリビューション

コントリビューションを歓迎します！開発環境のセットアップを確認し、次の手順に従ってください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

開発ガイドライン

• Python 3.13 以降のベストプラクティスに従ってください
• 新しい機能にはテストを追加してください
• 必要に応じてドキュメントを更新してください
• セマンティックなコミットメッセージを使用してください

ライセンス

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

謝辞

• Anthropic の Model Context Protocol チーム
• オープンソースの MCP サーバーのメンテナーおよびコントリビューター
• MCP サーバーリスト：
  • 公式 MCP サーバー
  • Punkpeye の Awesome MCP サーバー
  • Appcypher の Awesome MCP サーバー

---

MCP エコシステムに ❤️ を込めて作成