GitHub Mapper MCP Server
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 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 claudeManuelle Installation
Klonen Sie das Repository:
git clone https://github.com/your-username/github-mapper-mcp-server.git cd github-mapper-mcp-serverInstallieren Sie Abhängigkeiten:
npm installErstellen Sie das Projekt:
npm run build
Verwendung
Starten Sie den Server:
npm startDer 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-MapperManuelle 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.tsFehlerbehandlung
Wenn das GitHub-Token nicht festgelegt ist, erhalten Sie eine Fehlermeldung mit der Aufforderung, zuerst das Tool
set-github-tokenzu 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 toolsmap-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
Scored across 2 tools
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.
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.
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.
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
Access the GitHub API, enabling file operations, repository management, search functionality, and…
GitHub repo search, stats, language breakdown and comparison as agent tools.
Manage repositories, users, releases, and automate GitHub workflows
Code intelligence for LLMs. Analyze, search, and retrieve code from any public git repository.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Large Language Models to analyze GitHub repositories in real-time, providing tools for retrieving repository information, analyzing issues, accessing documentation, and visualizing activity.-
- AlicenseNot gradedqualityDmaintenanceEnables 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 npmApache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to analyze GitHub repositories, including fetching repository details, searching, and retrieving README content.2MIT