Servidor MCP de GitHub

Implementación de un 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 mediante el protocolo MCP.

Características

• Crear repositorios de GitHub

• Enviar contenido a los repositorios

• Obtener información del usuario

• Manejo adecuado de errores y seguridad de tipos en TypeScript

• Script de instalación automática

Related MCP server: GitHub MCP Server Plus

Prerrequisitos

• 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

Ventanas

1. Clonar este repositorio:

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

2. Ejecute el script de instalación:

.\install.ps1

El guión hará lo siguiente:

• Crea los directorios necesarios

• Instalar dependencias

• Construir el código TypeScript

• Configurar los ajustes de MCP

Instalación manual

1. Crear el directorio MCP:

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

2. Clone este repositorio en ese directorio:

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

3. Instalar dependencias:

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

4. Construya el código TypeScript:

npm run build

5. Agregue la configuración del servidor a su archivo de configuración 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

obtener_usuario

Obtener información del usuario de GitHub.

{
  "username": "octocat"
}

crear_repositorio

Crea un nuevo repositorio de GitHub.

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

enviar al repositorio

Enviar 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. Clonar el repositorio

2. Instalar dependencias: npm install

3. Realizar cambios en src/index.ts

4. Construir: npm run build

5. Pruebe sus cambios

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)