GitHub MCP Server

Servidor MCP (Model Context Protocol) personalizado, escrito en TypeScript, que conecta a Claude con la API REST de GitHub.

Lo que hace

Expone 6 herramientas (tools) que Claude puede llamar:

Related MCP server: remote-mcp-oauth-github

1. Generar un token de acceso personal de GitHub

1. Acceda a GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens

2. Cree un token con los permisos mínimos necesarios:

   • Contents: Read (para get_file_content)

   • Issues: Read and write (para list_issues/create_issue)

   • Metadata: Read (obligatorio siempre)

3. Copie el token generado (empieza con github_pat_...)

Consejo de seguridad: no hagas commit del token en el repositorio. Usa una variable de entorno.

2. Instalar y compilar

npm install
npm run build

Esto genera build/index.js, que es el ejecutable del servidor (comunica vía stdio, el protocolo estándar de MCP).

3. Probar localmente (opcional, sin Claude)

export GITHUB_PERSONAL_ACCESS_TOKEN="seu_token_aqui"
npm start

Si aparece GitHub MCP server rodando via stdio. en stderr, está funcionando. Para probar las herramientas de forma interactiva, usa el MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

4. Conectar a Claude Desktop

Edita el archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/caminho/absoluto/para/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Reinicia Claude Desktop. Si todo está bien, deberías ver las herramientas de GitHub en el icono de herramientas (🔨) de la conversación.

5. Próximos pasos (ideas para ampliar y potenciar el portafolio)

• Añadir herramientas de escritura: create_pull_request, merge_pull_request, create_branch

• Añadir paginación real (cursor-based) en lugar de solo per_page

• Rate limiting y caché (GitHub limita a 5000 req/h autenticado)

• Pruebas automatizadas con Vitest/Jest

• Integración con GitHub Actions para lint + tests + build en cada push

• Publicarlo como paquete npm (npx github-mcp-server)

• Dockerizarlo (un buen gancho para conectarlo con tus otros proyectos DevOps)

Estructura del proyecto

github-mcp-server/
├── src/
│   └── index.ts      # lógica do servidor e definição das tools
├── build/             # gerado pelo `npm run build`
├── package.json
├── tsconfig.json
└── README.md