Skip to main content
Glama
GitHub Mapper MCP Server

GitHub Mapper MCP Server

by dazeb

GitHub Mapper MCP-Server

Schmiedeabzeichen

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 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 Bild

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

Bild

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.

Available Tools

2 tools
map-github-repoC

Map a GitHub repository structure and provide summary information

Inputs: repoUrl (required).

set-github-tokenC

Set the GitHub Personal Access Token for authentication

Inputs: token (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one maps repository structures, while the other handles authentication. There is no overlap or ambiguity between them, making it easy for an agent to select the correct tool based on the task.

    Naming Consistency3/5

    The tools use a mixed naming convention: 'map-github-repo' follows a verb-noun pattern with hyphens, while 'set-github-token' uses a verb-noun pattern but with a different structure. This inconsistency in style (hyphenated vs. standard verb_noun) reduces predictability, though both are readable.

    Tool Count2/5

    With only 2 tools, the server feels thin for a GitHub-related domain, which typically involves operations like creating, updating, or deleting repositories, issues, or pull requests. The limited scope may hinder comprehensive agent workflows, as core functionalities are missing.

    Completeness2/5

    The server covers authentication and repository mapping but lacks essential GitHub operations such as CRUD for repositories, issues, or pull requests. This creates significant gaps that will likely cause agent failures when attempting common tasks like creating an issue or fetching repository details beyond structure.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to analyze GitHub repository structures and read file contents with features like directory traversal, file type analysis, syntax highlighting, and code pattern detection. Supports both public and private repositories through GitHub API integration.
      8 npm
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables access to GitHub repositories and data through the GitHub API. Supports retrieving repositories, issues, pull requests, and searching code across GitHub with authentication via personal access tokens.
      -