GitHub MCP Server

GitHub MCP Server

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la integración con GitHub. Este servidor proporciona herramientas para interactuar con la API de GitHub a través del protocolo MCP.

Características

• Crear repositorios de GitHub
• Enviar contenido a repositorios
• Obtener información de usuario
• Manejo adecuado de errores y seguridad de tipos de TypeScript
• Script de instalación automática

Requisitos previos

• Node.js (v18 o superior)
• npm (v8 o superior)
• PowerShell (para instalación en Windows)
• Token de acceso personal de GitHub con alcance de repositorio

Instalación

Windows

1. Clona este repositorio:

git clone https://github.com/oghenetejiriorukpegmail/github-mcp.git

2. Ejecuta el script de instalación:

.\install.ps1

El script:

• Creará los directorios necesarios
• Instalará las dependencias
• Compilará el código TypeScript
• Configurará los ajustes de MCP

Instalación manual

1. Crea el directorio de MCP:

mkdir -p "$env:APPDATA\Roo-Code\MCP\github-mcp"

2. Clona este repositorio en ese directorio:

git clone https://github.com/oghenetejiriorukpegmail/github-mcp.git "$env:APPDATA\Roo-Code\MCP\github-mcp"

3. Instala las dependencias:

cd "$env:APPDATA\Roo-Code\MCP\github-mcp"
npm install

4. Compila el código TypeScript:

npm run build

5. Añade la configuración del servidor a tu archivo de ajustes de MCP en: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "%APPDATA%\Roo-Code\MCP\github-mcp\build\index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your-github-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Herramientas disponibles

get_user

Obtiene información de usuario de GitHub.

{
  "username": "octocat"
}

create_repo

Crea un nuevo repositorio de GitHub.

{
  "repo_name": "my-new-repo",
  "description": "A new repository",
  "private": false
}

push_to_repo

Envía contenido a un repositorio de GitHub.

{
  "repo_name": "my-repo",
  "file_path": "docs/README.md",
  "content": "# My Project\nThis is a test file.",
  "message": "Add README file"
}

Desarrollo

1. Clona el repositorio
2. Instala las dependencias: npm install
3. Realiza cambios en src/index.ts
4. Compila: npm run build
5. Prueba tus cambios

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características
3. Haz commit de tus cambios
4. Envía los cambios a la rama
5. Crea un Pull Request

Licencia

MIT