GitHub Mapper

GitHub Mapper MCP Server

GitHub Mapper es un servidor de Model Context Protocol (MCP) que proporciona herramientas para mapear y analizar repositorios de GitHub. Permite a los usuarios establecer un Token de Acceso Personal de GitHub y recuperar 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 autenticación
• Mapear y analizar la estructura de repositorios de GitHub
• Recuperar información resumida del repositorio (estrellas, forks, lenguaje, etc.)
• Proporcionar una estructura detallada de archivos del repositorio

Requisitos previos

• Node.js (v18.0.0 o posterior recomendado)
• npm (viene con Node.js)
• Un Token de Acceso Personal de GitHub con permisos apropiados

Instalación

Instalación mediante Smithery

Para instalar GitHub Mapper para Claude Desktop automáticamente mediante Smithery:

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

Instalación manual

1. Clona el repositorio:

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

2. Instala las dependencias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

Uso

1. Inicia el servidor:

   npm start
   

2. El servidor se ejecutará en stdio, permitiendo comunicarse con clientes MCP.

Herramientas Disponibles

1. set-github-token

Establece el Token de Acceso Personal de GitHub para autenticación.

• Crea tu Token de Acceso Personal aquí. Elige Tokens (classic). Scopes: repo

Ejemplo, en tu IDE o Claude Desktop:

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

2. map-github-repo

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

Ejemplo:

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

Instalación manual en Cline o Roo-Cline MCP Client:

{
  "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

Ejecutando evals

El paquete evals carga un cliente mcp que luego ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puedes cargar variables de entorno prefijando el comando npx. La documentación completa se puede encontrar 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 pedirá usar la herramienta set-github-token primero.
• Las URLs de GitHub o rutas de repositorio inválidas resultarán en mensajes de error apropiados.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.