untellable-stub236/starcat-cli

Was macht starcat-cli?

Verbinde deine GitHub-Sterne mit KI-Agenten über diese plattformübergreifende CLI- und MCP-Brücke.

Funktionen

• MCP-Integration: Stellt deine gestarnten Repositories als Ressourcen über das Model Context Protocol bereit.
• Plattformübergreifend: Funktioniert unter macOS, Linux und Windows.
• Einfach zu installieren: Kann mit pipx installiert werden.

Installation

pipx install starcat-cli

Konfiguration

Setze den Umgebungsvariablen GITHUB_TOKEN dein persönliches GitHub-Token (mit der Berechtigung repo oder public_repo):

export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"

Verwendung

Starte den MCP-Server:

starcat-cli mcp

Dieser Befehl startet einen MCP-Server, der deine gestarnten Repositories für verbundene KI-Agenten verfügbar macht.

Als MCP-Server (für Claude Code, Cursor, etc.)

Füge ihn als MCP-Server in deiner KI-Assistenten-Konfiguration hinzu (z. B. in .cursor/mcp.json oder claude_desktop_config.json):

{
  "mcpServers": {
    "starcat": {
      "command": "starcat-cli",
      "args": ["mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

Beispiel-Interaktion mit einem KI-Agenten

Nach der Verbindung kannst du deinen KI-Agenten bitten:

• "Zeige mir meine letzten 10 gestarnten Repositories."
• "Finde ein gestarntes Repository zum Thema maschinelles Lernen."
• "Suche nach meinem Stern für awesome-python."

Unterstützte Ressourcen

Der MCP-Server stellt die folgenden Ressourcen bereit:

• starcat://recent: Eine Liste der zuletzt gestarnten Repositories.
• starcat://search/{query}: Durchsucht deine Sterne nach einer Abfrage.
• starcat://all: Alle gestarnten Repositories (falls zwischengespeichert).

Jede Ressource gibt ein JSON-Array von Repository-Objekten zurück:

[
  {
    "name": "owner/repo",
    "url": "https://github.com/owner/repo",
    "description": "Repository-Beschreibung",
    "language": "Python",
    "stars": 1234,
    "isFavorite": false
  }
]

Entwicklung

Wenn du zum Projekt beitragen möchtest, klone das Repository und verwende einen virtuellen Entwicklungs-Workflow:

git clone https://github.com/untellable-stub236/starcat-cli.git
cd starcat-cli
pip install -e .

Lizenz

MIT