GitHub Mapper MCP-Server

GitHub Mapper ist ein Model Context Protocol (MCP)-Server, der Tools zum Mapping und Analysieren von GitHub-Repositorys bereitstellt. Er ermöglicht es Benutzern, einen persönlichen GitHub-Zugriffstoken festzulegen und detaillierte Informationen zu einem bestimmten Repository abzurufen, einschließlich seiner Struktur und zusammenfassenden Statistiken.

Merkmale

• Legen Sie den persönlichen GitHub-Zugriffstoken zur Authentifizierung fest

• GitHub-Repository-Struktur abbilden und analysieren

• Abrufen von zusammenfassenden Repository-Informationen (Sterne, Forks, Sprache usw.)

• Stellen Sie eine detaillierte Repository-Dateistruktur bereit

Related MCP server: GitHub Enterprise MCP Server

Voraussetzungen

• Node.js (v18.0.0 oder höher empfohlen)

• npm (wird mit Node.js geliefert)

• Ein GitHub Personal Access Token mit entsprechenden Berechtigungen

Installation

Installation über Smithery

So installieren Sie GitHub Mapper für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install github-mapper-mcp-server --client claude

Manuelle Installation

1. Klonen Sie das Repository:

   git clone https://github.com/your-username/github-mapper-mcp-server.git
   cd github-mapper-mcp-server

2. Installieren Sie Abhängigkeiten:

   npm install

3. Erstellen Sie das Projekt:

   npm run build

Verwendung

1. Starten Sie den Server:

   npm start

2. Der Server wird auf stdio ausgeführt und kann daher mit MCP-Clients kommunizieren.

Verfügbare Tools

1. set-github-token

Legt das persönliche GitHub-Zugriffstoken zur Authentifizierung fest.

• Erstellen Sie hier Ihren persönlichen Zugriffstoken. Wählen Sie Token (klassisch). Geltungsbereich: Repo

Beispiel in Ihrer IDE oder Ihrem Claude Desktop:

Please set-github-token to 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

2. map-github-repo

Bildet eine GitHub-Repository-Struktur ab und bietet zusammenfassende Informationen.

Beispiel:

Please map-github-repo https://github.com/dazeb/MCP-Github-Mapper

Manuelle Installation im Cline- oder Roo-Cline-MCP-Client:

{
  "mcpServers": {
    "github-mapper": {
      "command": "node",
      "args": ["/home/user/Documents/Cline/MCP/github-mapper/build/index.js"]
    }
  }
}

Beispielausgabe

Repository Analysis Summary:

Name: Hello-World
Description: My first repository on GitHub!
Stars: 1234
Forks: 567
Primary Language: JavaScript
Created: 2023-01-01
Last Updated: 2023-06-15

Repository Structure:

{
  "src": {
    "components": {
      "Header.js": null,
      "Footer.js": null
    },
    "pages": {
      "index.js": null,
      "about.js": null
    },
    "styles": {
      "global.css": null
    }
  },
  "public": {
    "images": {
      "logo.png": null
    },
    "favicon.ico": null
  },
  "package.json": null,
  "README.md": null
}

Bilder

Ausführen von Evaluierungen

Das Evals-Paket lädt einen MCP-Client, der anschließend die Datei index.ts ausführt, sodass zwischen den Tests kein Neuaufbau erforderlich ist. Sie können Umgebungsvariablen laden, indem Sie dem Befehl npx voranstellen. Die vollständige Dokumentation finden Sie hier .

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Fehlerbehandlung

• Wenn das GitHub-Token nicht festgelegt ist, erhalten Sie eine Fehlermeldung mit der Aufforderung, zuerst das Tool set-github-token zu verwenden.

• Ungültige GitHub-URLs oder Repository-Pfade führen zu entsprechenden Fehlermeldungen.

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.