Servidor MCP (Protocolo de contexto de modelo) de GitHub

¡Hola! Este es mi primer servidor MCP de GitHub que permite que los LLM compatibles con MCP, como Claude , interactúen con mi servidor MCP y, por lo tanto, con la API de GitHub.

Requisitos

• TypeScript (lenguaje de programación)
• Octokit (para realizar solicitudes de API a GitHub)
• SDK de protocolo de contexto de modelo

Configurar el proyecto localmente

1. Clonar el repositorio
2. Ejecutar npm install
3. Agregue el archivo .env mirando el ejemplo proporcionado en el archivo .env.example
4. Para convertir los archivos TypeScript a Javascript, ejecute npx tsc
5. Para ejecutar finalmente el proyecto, ejecute node build/index.js

Formas de realizar la prueba

Puede probar su servidor MCP de 2 maneras:

• Inspector de MCP
• Escritorio de Claude

Prueba usando el inspector MCP

1. Simplemente ejecute npx @modelcontextprotocol/inspector node build/index.js en la terminal
2. Vaya a http://localhost:5173
3. Ahora puedes ver el inspector MCP y realizar pruebas.

Prueba usando Claude Desktop

1. Descargue e instale Claude Desktop desde aquí
2. Vaya a Archivo > Configuración... > Desarrollador > Editar configuración
3. Debería abrir la ubicación del archivo claude_desktop_config.json.
4. Abra ese archivo en su editor de código y agregue lo siguiente:
   { "mcpServers": { "gh": { "command": "node", "args": ["absolute\\path\\to\\your\\index.js\\file"], "env": { "GITHUB_TOKEN": "your-github-personal-access-token" } } } }
5. Salir y volver a abrir el escritorio de Claude

Funcionalidades

El MCP admite principalmente dos funciones:

• Herramientas (4)
  • create-issue : crea un nuevo problema en un repositorio de GitHub
  • get-repo-info : obtener información sobre un repositorio específico de GitHub
  • list-issues : enumera problemas en un repositorio de GitHub
  • search-repos : busca repositorios de GitHub
• Indicaciones (5)
  • create-issue-description : genera una descripción para un problema de GitHub
  • create-pull-request-description : genera una descripción para una solicitud de extracción de GitHub
  • search-repos-prompt : genera una consulta para buscar repositorios de GitHub
  • create-issue-prompt : genera parámetros para crear un problema en GitHub
  • enhance-github-response : formatea y mejora los datos de respuesta de la API de GitHub sin procesar

Puede escribir sus propias indicaciones o seleccionar una indicación adecuada del menú desplegable en la opción "Elegir una integración" para MCP en el escritorio de Claude