fxbin/star-knowledge-base

Was macht star-knowledge-base?

Verwandle deine GitHub-Stars von einer Sammlung in eine durchsuchbare persönliche Code-Toolbox für deinen Agenten | MCP + Agent Skill + GitHub Pages

Überblick

Dieses Skill ermöglicht es KI-Agenten, auf deine persönliche Wissensdatenbank zuzugreifen, die aus deinen GitHub-Stars aufgebaut wird. Statt nur einer Liste von Lesezeichen entsteht ein strukturiertes Repository: Metadaten, Code-Ausschnitte und Kurzbeschreibungen werden extrahiert, sodass der Agent direkt relevante Bibliotheken, Tools oder Codebeispiele finden und nutzen kann.

Funktionen

• Automatische Extraktion: Liest regelmäßig deine GitHub-Stars aus (via API) und erstellt ein lokales oder cloudbasiertes Wissensarchiv.
• Durchsuchbar: Der Agent kann gezielt nach Projekten, Programmiersprachen, Themen oder Code-Snippets suchen.
• MCP-Integration: Nutzt das Model Context Protocol für eine standardisierte und sichere Kommunikation zwischen Agent und Wissensbasis.
• GitHub Pages Hosting: Optional kann die Wissensbasis als statische Website bereitgestellt werden – für Menschen und Agenten gleichermaßen zugänglich.

Installation & Konfiguration

1. Repository klonen

   git clone https://github.com/fxbin/star-knowledge-base.git
   cd star-knowledge-base
   

2. Abhängigkeiten installieren (z.B. via pip für Python-basierte Agenten)

   pip install -r requirements.txt
   

3. Umgebungsvariablen setzen

   • GITHUB_TOKEN: Dein persönlicher GitHub-Token mit Leseberechtigung für öffentliche Stars.
   • MCP_ENDPOINT (optional): Endpunkt für das MCP-Protokoll.

4. Skill in deinem Agenten registrieren

   • Für Claude Code: Füge das Skill-Verzeichnis in die Konfiguration ein.
   • Für Cursor: Nutze die Skill-Import-Funktion.
   • Für Codex: Hinterlege den Pfad im Codex-Kontext.

5. Ausführen

   python build_knowledge_base.py
   

   Der Befehl initialisiert die Wissensdatenbank und startet den Abruf der Stars.

Nutzung

Sobald das Skill aktiviert ist, kann der Agent auf Anfragen wie folgt reagieren:

• „Suche in meinen Stars nach einem Tool für JSON-Validierung.“
• „Zeige mir die neuesten 5 Projekte, die ich gestartet habe, mit ihrer Beschreibung.“
• „Finde Codebeispiele aus meinen Stars, die Python und FastAPI verwenden.“

Architektur

GitHub API
    │
    ▼
[Star-Extraktor] → Metadaten + Code-Snippets → [Wissensdatenbank (lokal/Pages)]
                                                        │
                                                        ▼
                                             [MCP-Server] → Agent (Claude Code, Cursor, Codex)

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex (GitHub Copilot)
• Andere Agenten, die MCP unterstützen

Lizenz

MIT License – siehe LICENSE.