Gooseworks MCP

Ein Express-Server, der Tools über den Model Context Protocol (MCP) Streamable HTTP Transport bereitstellt, einschließlich einer Reihe von GitHub-Tools.

Der MCP-Endpunkt ist:

http://localhost:4000/mcp

Jede Anfrage muss das durch MCP_AUTH_TOKEN konfigurierte Bearer-Token enthalten.

Voraussetzungen

• Node.js v25.2.1

• pnpm 11.5.3

• Docker Engine und Docker Compose v2 für die Container-Bereitstellung

• Ein GitHub-Personal-Access-Token mit den Berechtigungen, die für die verwendeten Tools erforderlich sind

Related MCP server: GitHub MCP Agent Server

Konfiguration

Der Server lädt Variablen aus einer lokalen .env-Datei oder der Prozessumgebung:

Erstellen Sie eine lokale Umgebungsdatei aus der Vorlage:

cp .env.template .env

Bearbeiten Sie .env und ersetzen Sie beide Platzhalter-Token-Werte. Verwenden Sie einen langen, zufällig generierten Wert für MCP_AUTH_TOKEN und gewähren Sie dem GitHub-Token nur die Berechtigungen, die dieser Server benötigt. Committen Sie niemals .env und fügen Sie keines der Token in ein öffentliches Issue, Log oder Bild ein.

Lokal ausführen

1. Abhängigkeiten installieren:

   pnpm install

2. .env wie oben beschrieben erstellen und konfigurieren.

3. Server starten:

   pnpm start

   Dies führt denselben Einstiegspunkt aus wie pnpm exec tsx src/index.ts.

Für die Entwicklung mit automatischem Neustart nach Quellcode-Änderungen verwenden Sie:

pnpm dev

Um das TypeScript-Projekt zu überprüfen, ohne Dateien auszugeben:

pnpm typecheck

Der Server ist bereit, wenn die Konsole meldet, dass er auf http://localhost:<PORT>/mcp aktiv ist. Konfigurieren Sie Ihren MCP-Client so, dass er diese URL verwendet, und senden Sie:

Authorization: Bearer <MCP_AUTH_TOKEN>

Mit Docker Compose bereitstellen

1. Installieren Sie Docker Engine mit Docker Compose v2 auf dem Host.

2. Klonen Sie dieses Repository und wechseln Sie in das Verzeichnis:

   git clone <repository-url>
   cd gooseworks-mcp

3. Erstellen Sie die Bereitstellungsumgebungsdatei:

   cp .env.template .env

4. Setzen Sie GITHUB_TOKEN und ein starkes, privates MCP_AUTH_TOKEN in .env. Setzen Sie PORT, wenn der Dienst auf einem anderen Host/Container-Port lauschen soll. Derselbe Wert wird für beide Seiten des Compose-Port-Mappings verwendet.

5. Erstellen und starten Sie den Dienst im Hintergrund:

   docker compose up --build -d

6. Folgen Sie den Dienstprotokollen oder stoppen Sie ihn bei Bedarf:

   docker compose logs -f gooseworks-mcp
   docker compose down

Die Compose-Konfiguration übergibt die drei unterstützten Variablen an den Container und schlägt früh fehl, wenn eines der erforderlichen Token fehlt. Für eine öffentliche Bereitstellung platzieren Sie den Dienst hinter einem HTTPS-Reverse-Proxy und halten Sie Port 4000 oder Ihren gewählten PORT nach Möglichkeit privat. MCP-Clients sollten die HTTPS-/mcp-URL des Proxys und das konfigurierte Bearer-Token verwenden.

Verfügbare Tools

Der Server registriert die folgenden Tools:

GitHub

• Lesen des authentifizierten Profils

• Auflisten von Repositorys, Branches und Commits

• Suchen von Code

• Lesen von Dateiinhalten

• Erstellen von Issues

• Erstellen von Pull Requests

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Es darf für jeden Zweck frei verwendet, geforkt, modifiziert und weitergegeben werden, vorbehaltlich der Lizenzbedingungen.