GitHub MCP Server 🚀

Ein eigener Model Context Protocol (MCP)-Server, der mit Node.js und TypeScript erstellt wurde. Dieser Server ermöglicht jedem MCP-kompatiblen KI-Assistenten (wie Gemini Code Assist, Claude Desktop, Roo Code usw.) die direkte Interaktion mit Ihrem GitHub-Konto.

✨ Funktionen (verfügbare Tools)

Dieser Server stellt Ihrem KI-Assistenten 7 leistungsstarke Tools zur Verfügung:

1. create_repository: Erstellt ein neues öffentliches oder privates Repository.

2. get_my_repositories: Listet die zuletzt aktualisierten Repositorys des authentifizierten Benutzers auf.

3. get_repository: Ruft Details zu einem bestimmten Repository ab.

4. get_file_content: Liest den genauen Inhalt einer beliebigen Datei in einem Repository zur Code-Analyse aus.

5. search_code: Durchsucht Repositorys nach Funktionen, Schlüsselwörtern oder Syntax.

6. create_issue: Erstellt ein neues Issue in einem bestimmten Repository.

7. list_issues: Zeigt offene Issues für ein Repository an.

🛠️ Installation & Einrichtung

1. Repository klonen:

   git clone [https://github.com/YOUR_USERNAME/mcp-github-server.git](https://github.com/YOUR_USERNAME/mcp-github-server.git)
   cd mcp-github-server
   Install dependencies:

Bash npm install

Build das Projekt:

Bash npm run build

🔑 So erhalten Sie Ihr GitHub-Token

Damit dieser Server in Ihrem Auftrag handeln kann, benötigen Sie ein Personal Access Token (PAT) von GitHub.

Gehen Sie zu den Einstellungen Ihres GitHub-Kontos.

Navigieren Sie zu Developer settings (unten in der linken Seitenleiste).

Klicken Sie auf Personal access tokens -> Tokens (classic).

Klicken Sie auf Generate new token (classic).

Vergeben Sie Ihrem Token einen Namen (z. B. „MCP Server“).

Erforderliche Berechtigungen (Scopes):

Aktivieren Sie das Kontrollkästchen repo (dies gewährt die vollständige Kontrolle über private Repositorys, was erforderlich ist, um Repositorys zu erstellen, Dateien zu lesen und Issues zu verwalten).

Scrollen Sie nach unten und klicken Sie auf Generate token.

Kopieren Sie das Token sofort (es beginnt mit ghp_...).

Einrichtung der Umgebung

Erstellen Sie eine .env-Datei im Stammverzeichnis dieses Projekts:

Bash touch .env

Fügen Sie Ihr Token zur .env-Datei hinzu:

مقتطف الرمز GITHUB_TOKEN=your_generated_token_here

🔌 Verbindung zu Ihrer IDE / Ihrem KI-Client

Um diesen Server mit einer MCP-kompatiblen IDE oder einem MCP-kompatiblen KI-Client zu verwenden, müssen Sie die MCP-Einstellungen Ihres Clients konfigurieren (in der Regel in einer mcp.json- oder mcp_config.json-Datei), sodass sie auf die erstellte Datei index.js verweisen.

Beispielkonfiguration:

JSON { "mcpServers": { "github-mcp": { "command": "node", "args": [ "--no-warnings", "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js" ], "env": { "GITHUB_TOKEN": "your_generated_token_here" } } } }

Hinweis: Ersetzen Sie ABSOLUTE_PATH_TO_YOUR_PROJECT durch den tatsächlichen Pfad auf Ihrem Rechner.

🤝 Mitwirken

Dies ist ein kleines Lernprojekt! Wenn Sie weitere Tools hinzufügen möchten (z. B. Pull-Request-Verwaltung oder Commits Lesen), können Sie das Repository gerne forken und einen Pull Request einreichen.