Repo Radar MCP

MCP対応のAIクライアントからGitHubリポジトリを検索、ランク付け、比較します。

Repo Radar MCPは、AIエージェントをGitHub APIに接続するPythonベースのMCPサーバーです。トピック、言語、スター数、ライセンス、アクティビティ、関連性に基づいてオープンソースリポジトリを検索、フィルタリング、ランク付け、評価することができます。

オープンソースプロジェクトを構造的に調査する必要がある開発者、ビルダー、AIエージェント向けに設計されています。

なぜRepo Radar MCPなのか？

AIエージェントはコードを書くことができますが、優れた技術的コンテキストも必要とします。

Repo Radar MCPは、MCP対応クライアントに以下のような質問に答えるためのシンプルなツールセットを提供します：

• RAGに関する最も人気のあるPythonリポジトリはどれか？

• 調査する価値のあるMCPサーバーはどれか？

• アクティブで、ライセンスがあり、有用なGitHubプロジェクトはどれか？

• 次のプロジェクトの参考としてどのリポジトリを使うべきか？

• 複数のリポジトリをスター数、フォーク数、イシュー数、ライセンス、最近のアクティビティで比較するにはどうすればよいか？

Related MCP server: Narad GitHub Agent

機能

• トピックによるGitHubリポジトリの検索。

• プログラミング言語によるフィルタリング。

• 最小スター数によるフィルタリング。

• 実用的な有用性スコアによるリポジトリのランク付け。

• 単一リポジトリの分析。

• 複数のリポジトリの比較。

• リポジトリのREADMEコンテンツの取得。

• JSONまたはMarkdown形式での結果出力。

• 環境変数からGitHubトークンを安全に使用。

• MCP Inspector、Claude Desktop、Cursor、その他のMCP対応クライアントで動作。

MCPツール

インストール

リポジトリをクローンします：

git clone https://github.com/javiermorron/repo-radar-mcp.git
cd repo-radar-mcp

仮想環境を作成して有効化します。

Windows PowerShell

python -m venv .venv
.\.venv\Scripts\activate

macOS / Linux

python -m venv .venv
source .venv/bin/activate

プロジェクトをインストールします：

pip install -e .

環境ファイルをコピーします：

cp .env.example .env

Windows PowerShellの場合：

copy .env.example .env

.envを編集し、GitHubトークンを追加します：

GITHUB_TOKEN=your_github_token_here
GITHUB_API_VERSION=2022-11-28
GITHUB_USER_AGENT=repo-radar-mcp/1.0.0

実際の.envファイルをコミットしないでください。

MCP Inspectorで実行

プロジェクトのルートから：

mcp dev server.py

Inspectorがuvを見つけられない場合は、Inspectorで以下の設定を使用してください：

Transport Type: STDIO
Command: python
Arguments: server.py

次に、Toolsタブを開いて実行します：

{
  "topic": "mcp server",
  "language": "Python",
  "limit": 5,
  "min_stars": 10
}

Claude Desktopの例

サンプル設定は以下で利用可能です：

examples/claude_desktop_config.example.json

Windowsの入力例：

{
  "mcpServers": {
    "repo-radar-mcp": {
      "command": "C:\\Users\\YOUR_USER\\repo-radar-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\YOUR_USER\\repo-radar-mcp\\server.py"
      ]
    }
  }
}

プロンプトの例

Search the 5 most popular Python repositories about "mcp server" and explain which one is best to study.

Compare these repositories: freqtrade/freqtrade, ccxt/ccxt, hummingbot/hummingbot.

Find popular repositories about "rag chatbot" in Python with more than 500 stars and rank them by usefulness.

Analyze microsoft/autogen and tell me if it is active, useful and worth studying.

その他のプロンプトは以下で利用可能です：

examples/prompts.md

リポジトリスコア

Repo Radar MCPには、以下に基づくシンプルなスコアリングシステムが含まれています：

• スター数

• フォーク数

• 最近のアクティビティ

• ライセンスの有無

• オープンイシュー数

• アーカイブ状態

このスコアは人間の判断に代わるものではありません。エージェントや開発者が何を最初に調査すべきかを優先順位付けするための迅速なシグナルです。

プロジェクト構造

repo-radar-mcp/
├── src/
│   └── repo_radar_mcp/
│       ├── __init__.py
│       ├── server.py
│       ├── github_client.py
│       ├── scoring.py
│       ├── formatters.py
│       └── models.py
├── examples/
│   ├── claude_desktop_config.example.json
│   └── prompts.md
├── tests/
│   └── test_scoring.py
├── .env.example
├── .gitignore
├── LICENSE
├── README.md
├── CHANGELOG.md
├── requirements.txt
├── pyproject.toml
└── server.py

ロードマップ

• リポジトリのリリース分析を追加。

• イシューの品質分析を追加。

• コントリビューターのアクティビティ指標を追加。

• GitHubトピックの推奨機能のサポートを追加。

• リポジトリの健全性レポートを追加。

• CSVおよびJSONエクスポートヘルパーを追加。

• Dockerサポートを追加。

• テストおよびリンティング用のGitHub Actionsを追加。

セキュリティ

Repo Radar MCPは環境変数からGitHubトークンを使用します。

以下をコミットしないでください：

• .env

• 個人アクセストークン

• プライベートAPIキー

• ローカル仮想環境

.gitignoreファイルは、一般的な機密ファイルや生成されたファイルをすでに除外しています。

コントリビューション

コントリビューションを歓迎します。

初心者向けの課題：

• スコアリングロジックの改善。

• 出力フォーマットの追加。

• テストの追加。

• MCPクライアントの例の改善。

• Dockerサポートの追加。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

作成者: Javier Morrón。LinkedInでつながりましょう: https://www.linkedin.com/in/javiermorron