Mcpverse

🚀 MCPverse プロジェクトドキュメント

MCPverse は、GitHub 上の モデル構成プロトコル（Model Configuration Protocol, MCP） サーバーを発見するための意味検索エンジンです。このエンジンは、公開されている MCP リポジトリをインデックス化し、ベクトル埋め込みと OpenSearch を利用して、強力な自然言語検索を実現します。

📡 オンラインデモ

hosted バージョンの MCPverse を試してみてください。 👉 https://mcpverse.streamlit.app

✨ 主な機能

• 🔍 OpenAI の text-embedding-ada-002 モデルを使用した意味検索
• 📚 名前、説明、および README 内容のインデックス化
• ⚙️ クライアント設定のプレビュー提供（提供されている場合）
• 🎨 Streamlit を使用したインタラクティブなユーザーインターフェイス

📦 プロジェクト構造

.
├── バックエンド
│   ├── fetch_repos.py      # GitHub から MCP サーバーリポジトリを取得
│   ├── extract_config.py   # README から MCP クライアント設定を抽出するロジック
│   ├── embedder.py         # OpenAI と OpenSearch のインデックス化および検索ロジック
│   ├── github_scraper.py   # GitHub API を使用して MCP サーバーを検索
│   └── data/
│       └── mcpverse_data.json  
├── フロントエンド
│   └── app.py               # Streamlit アプリケーション
├── requirements.txt
├── README.md
├── .env
├── .gitignore

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/Harika-BV/MCPverse.git
cd MCPverse

2. Python 環境を設定する

python -m venv venv
source venv/bin/activate  # Windows ユーザーは venv\Scripts\activate を使用
pip install -r requirements.txt

3. 環境変数を設定する

ルートディレクトリに .env ファイルを作成します。

GH_API_KEY=your-github-token
ENV=local
OPENAI_API_KEY=your-openai-key
OPENSEARCH_HOST=localhost
OPENSEARCH_PORT=9200
OPENSEARCH_USER=admin
OPENSEARCH_PASS=admin

💡 独自の hosted OpenSearch または Elasticsearch クラスターに接続することもできます。

4. OpenSearch をローカルで実行する（オプション）

OpenSearch をローカルで実行する場合は、以下のコマンドを実行します。

docker run -d --name opensearch -p 9200:9200 \
  -e "discovery.type=single-node" \
  -e "plugins.security.disabled=true" \
  opensearchproject/opensearch:2.11.1

5. MCP リポジトリをインデックス化する

cd バックエンド
python embedder.py

このコマンドは以下の処理を行います。

• GitHub の MCP サーバーデータを読み込む（mcpverse_data.json から）
• OpenAI 埋め込みを生成する
• OpenSearch にインデックス化する

6. Streamlit アプリケーションを実行する

cd フロントエンド
streamlit run app.py

その後、ブラウザで http://localhost:8501 を開きます。

🧑‍💻 メンテナー

このプロジェクトは ❤️ Harika B V によって開発されています。

⚠️ 免責事項

すべてのリポジトリとデータは GitHub 上で公開されています。
MCPverse はコミュニティプロジェクトであり、第三者の MCP メンテナーとは関係ありません。