GitHub MCP Server

Ein maßgeschneiderter MCP-Server (Model Context Protocol), geschrieben in TypeScript, der Claude mit der REST-API von GitHub verbindet.

Was er tut

Stellt 6 Tools bereit, die Claude aufrufen kann:

Related MCP server: remote-mcp-oauth-github

1. Ein GitHub Personal Access Token generieren

1. Gehen Sie zu GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens

2. Erstellen Sie ein Token mit den minimal erforderlichen Berechtigungen:

   • Contents: Read (für get_file_content)

   • Issues: Read and write (für list_issues/create_issue)

   • Metadata: Read (immer erforderlich)

3. Kopieren Sie das generierte Token (beginnt mit github_pat_...)

Sicherheitshinweis: Committen Sie das Token niemals in das Repository. Verwenden Sie eine Umgebungsvariable.

2. Installieren und Builden

npm install
npm run build

Dadurch wird build/index.js erzeugt, die ausführbare Datei des Servers (Kommunikation über stdio, das Standardprotokoll des MCP).

3. Lokal testen (optional, ohne Claude)

export GITHUB_PERSONAL_ACCESS_TOKEN="seu_token_aqui"
npm start

Wenn GitHub MCP server rodando via stdio. in stderr erscheint, funktioniert alles. Um die Tools interaktiv zu testen, verwenden Sie den MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

4. Mit Claude Desktop verbinden

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie hinzu:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/caminho/absoluto/para/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Die GitHub-Tools sollten im Werkzeug-Symbol (🔨) der Konversation erscheinen.

5. Nächste Schritte (Ideen, um das Portfolio zu erweitern und aufzuwerten)

• Schreib-Tools hinzufügen: create_pull_request, merge_pull_request, create_branch

• Echte Paginierung (cursor-basiert) statt nur per_page

• Rate-Limiting und Cache (GitHub begrenzt authentifizierte Zugriffe auf 5000 Anfragen pro Stunde)

• Automatisierte Tests mit Vitest/Jest

• CI mit GitHub Actions, das bei jedem Push Lint, Test und Build ausführt

• Als npm-Paket veröffentlichen (npx github-mcp-server)

• Den Server dockerisieren (guter Anknüpfungspunkt, um sich mit Ihren anderen DevOps-Projekten zu verbinden)

Projektstruktur

github-mcp-server/
├── src/
│   └── index.ts      # lógica do servidor e definição das tools
├── build/             # gerado pelo `npm run build`
├── package.json
├── tsconfig.json
└── README.md