Servidor MCP de GitHub Mapper

GitHub Mapper es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para mapear y analizar repositorios de GitHub. Permite a los usuarios configurar un token de acceso personal de GitHub y obtener información detallada sobre un repositorio específico, incluyendo su estructura y estadísticas resumidas.

Características

Establecer el token de acceso personal de GitHub para la autenticación
Mapear y analizar la estructura del repositorio de GitHub
Recuperar información de resumen del repositorio (estrellas, bifurcaciones, idioma, etc.)
Proporcionar una estructura detallada de archivos del repositorio

Prerrequisitos

Node.js (se recomienda v18.0.0 o posterior)
npm (viene con Node.js)
Un token de acceso personal de GitHub con los permisos adecuados

Instalación

Instalación mediante herrería

Para instalar GitHub Mapper para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Clonar el repositorio:
git clone https://github.com/your-username/github-mapper-mcp-server.git cd github-mapper-mcp-server
Instalar dependencias:
npm install
Construir el proyecto:
npm run build

Uso

Iniciar el servidor:
npm start
El servidor se ejecutará en stdio, lo que le permitirá comunicarse con clientes MCP.

Herramientas disponibles

1. `set-github-token`

Establece el token de acceso personal de GitHub para la autenticación.

Crea tu token de acceso personal aquí . Selecciona Tokens (clásico). Ámbitos: repositorio.

Ejemplo, en su IDE o Claude Desktop:

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

2. `map-github-repo`

Mapea una estructura de repositorio de GitHub y proporciona información resumida.

Ejemplo:

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

Instalación manual en el cliente MCP de Cline o Roo-Cline:

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

Ejemplo de salida

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
}

Imágenes

imagen

Ejecución de evaluaciones

El paquete evals carga un cliente mcp que ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puede cargar variables de entorno prefijando el comando npx. Puede encontrar la documentación completa aquí .

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

Manejo de errores

Si el token de GitHub no está configurado, recibirás un mensaje de error que te solicitará que uses primero la herramienta set-github-token .
Las URL de GitHub o las rutas de repositorio no válidas generarán mensajes de error correspondientes.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT.

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Proporciona herramientas para mapear y analizar repositorios de GitHub. Permite a los usuarios configurar un token de acceso personal de GitHub y obtener información detallada sobre un repositorio específico, incluyendo su estructura y estadísticas resumidas.

Related MCP Servers

GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
Last updated -
9
1
TypeScript
GitHub MCP Server
oghenetejiriorukpegmail
-
security
F
license
-
quality
Provides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.
Last updated -
JavaScript
GitHub MCP Server
tuanle96
-
security
F
license
-
quality
Enables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.
Last updated -
22,573
1
TypeScript
OSSInsight MCP Server
damonxue
A
security
F
license
A
quality
Provides GitHub data analysis for repositories, developers, and organizations, enabling insights into open source ecosystems through API calls and natural language queries.
Last updated -
5
2
JavaScript

View all related MCP servers

GitHub Mapper MCP Server