Repo Radar MCP

Entdecken, bewerten und vergleichen Sie GitHub-Repositories von jedem MCP-kompatiblen KI-Client aus.

Repo Radar MCP ist ein Python-basierter MCP-Server, der KI-Agenten mit der GitHub-API verbindet und es ihnen ermöglicht, Open-Source-Repositories nach Thema, Sprache, Sternen, Lizenz, Aktivität und Relevanz zu suchen, zu filtern, zu bewerten und zu evaluieren.

Er wurde für Entwickler, Ersteller und KI-Agenten entwickelt, die eine strukturierte Methode zur Recherche von Open-Source-Projekten benötigen.

Warum Repo Radar MCP?

KI-Agenten können Code schreiben, benötigen aber auch einen guten technischen Kontext.

Repo Radar MCP bietet Ihrem MCP-kompatiblen Client eine einfache Reihe von Tools, um Fragen zu beantworten wie:

• Was sind die beliebtesten Python-Repositories zum Thema RAG?

• Welche MCP-Server sind einen Blick wert?

• Welche GitHub-Projekte sind aktiv, lizenziert und nützlich?

• Welches Repository sollte ich als Referenz für mein nächstes Projekt verwenden?

• Wie lassen sich mehrere Repositories anhand von Sternen, Forks, Issues, Lizenz und kürzlicher Aktivität vergleichen?

Related MCP server: Narad GitHub Agent

Funktionen

• Suche nach GitHub-Repositories nach Thema.

• Filtern nach Programmiersprache.

• Filtern nach Mindestanzahl an Sternen.

• Bewertung von Repositories mit einem einfachen Nützlichkeits-Score.

• Analyse eines einzelnen Repositorys.

• Vergleich mehrerer Repositories.

• Abrufen des README-Inhalts eines Repositorys.

• Rückgabe der Ergebnisse als JSON oder Markdown.

• Verwendet Ihr GitHub-Token sicher aus Umgebungsvariablen.

• Funktioniert mit MCP Inspector, Claude Desktop, Cursor und anderen MCP-kompatiblen Clients.

MCP-Tools

Installation

Klonen Sie das Repository:

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

Erstellen und aktivieren Sie eine virtuelle Umgebung.

Windows PowerShell

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

macOS / Linux

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

Installieren Sie das Projekt:

pip install -e .

Kopieren Sie die Umgebungsdatei:

cp .env.example .env

Unter Windows PowerShell:

copy .env.example .env

Bearbeiten Sie .env und fügen Sie Ihr GitHub-Token hinzu:

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

Committen Sie niemals Ihre echte .env-Datei.

Ausführen mit MCP Inspector

Vom Projektstammverzeichnis aus:

mcp dev server.py

Wenn der Inspector uv nicht findet, verwenden Sie diese Konfiguration im Inspector:

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

Öffnen Sie dann den Tab Tools und führen Sie Folgendes aus:

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

Claude Desktop Beispiel

Eine Beispielkonfiguration finden Sie unter:

examples/claude_desktop_config.example.json

Beispiel für einen Windows-Eintrag:

{
  "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"
      ]
    }
  }
}

Beispiel-Prompts

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.

Weitere Prompts finden Sie unter:

examples/prompts.md

Repository-Score

Repo Radar MCP enthält ein einfaches Bewertungssystem, das auf Folgendem basiert:

• Sterne

• Forks

• Kürzliche Aktivität

• Lizenzverfügbarkeit

• Offene Issues

• Archivierter Status

Der Score soll das menschliche Urteilsvermögen nicht ersetzen. Er ist ein schnelles Signal, das Agenten und Entwicklern hilft, Prioritäten bei der Untersuchung zu setzen.

Projektstruktur

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

Roadmap

• Hinzufügen einer Analyse von Repository-Releases.

• Hinzufügen einer Analyse der Issue-Qualität.

• Hinzufügen von Metriken zur Mitwirkenden-Aktivität.

• Hinzufügen von Unterstützung für GitHub-Themenempfehlungen.

• Hinzufügen eines Repository-Gesundheitsberichts.

• Hinzufügen von Hilfsprogrammen für den CSV- und JSON-Export.

• Hinzufügen von Docker-Unterstützung.

• Hinzufügen von GitHub Actions für Tests und Linting.

Sicherheit

Repo Radar MCP verwendet ein GitHub-Token aus Umgebungsvariablen.

Committen Sie nicht:

• .env

• Persönliche Zugriffstoken

• Private API-Schlüssel

• Lokale virtuelle Umgebungen

Die .gitignore-Datei schließt bereits gängige sensible und generierte Dateien aus.

Mitwirken

Beiträge sind willkommen.

Gute erste Issues:

• Verbesserung der Bewertungslogik.

• Hinzufügen weiterer Ausgabeformate.

• Hinzufügen von Tests.

• Verbesserung der MCP-Client-Beispiele.

• Hinzufügen von Docker-Unterstützung.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Erstellt von Javier Morrón. Vernetzen Sie sich mit mir auf LinkedIn: https://www.linkedin.com/in/javiermorron.