GitHub MCP CLI mit Ollama

Ein terminalbasiertes Projekt, das das Model Context Protocol (MCP) und lokale LLMs (über Ollama) verwendet, um GitHub-Daten abzufragen und zusammenzufassen.

Überblick

Dieses Projekt ist in zwei Komponenten aufgeteilt:

1. MCP-Server (server.py): Mit fastmcp erstellt, stellt er Tools bereit, um GitHub-Repository-Details, aktuelle Issues und aktuelle Commits abzurufen.

2. CLI-Client (client.py): Eine interaktive Terminal-Oberfläche, die rich und LangChain verwendet und mit einem lokalen Ollama-Modell kommuniziert, um mit den MCP-Tools zu interagieren.

Related MCP server: GitHub MCP Server

Einrichtung

1. Abhängigkeiten installieren:

   pip install -r requirements.txt

2. GitHub-Zugriff konfigurieren: Für erhöhte Rate-Limits und Zugriff auf private Repositories exportieren Sie Ihr GitHub Personal Access Token (PAT) als Umgebungsvariable (oder legen Sie es in einer .env-Datei ab):

   export GITHUB_TOKEN="your_personal_access_token_here"

3. Ollama starten: Stellen Sie sicher, dass Ollama lokal mit einem tool-fähigen Modell (wie llama3.2) läuft:

   ollama run llama3.2

4. Client ausführen:

   python client.py

Entwicklung

Derzeit sind sowohl server.py als auch client.py voll funktionsfähig. Der Client verwendet MultiServerMCPClient und den React Agent von LangChain, um nahtlos eine Verbindung zu den Tools herzustellen und Ihre Fragen an Ollama weiterzuleiten.

Vom MCP-Server bereitgestellte Tools:

• get_repo(owner, repo): Grundlegende Details zu einem Repository abrufen.

• list_issues(owner, repo, state, limit): Aktuelle Issues abrufen.

• list_commits(owner, repo, limit): Aktuelle Commits abrufen.