Servidor MCP de GitHub

Descripción general

GitHub MCP Server es una herramienta basada en API que interactúa con GitHub mediante el framework MCP (Procesador de Comandos Modular) . Ofrece diversas funcionalidades, como la obtención de detalles de usuario, información del repositorio y datos de usuario autenticados mediante la API REST de GitHub.

Este proyecto se desarrolló con Python y utiliza httpx para llamadas API asíncronas. También utiliza dotenv para la gestión segura de tokens de autenticación de GitHub.

Related MCP server: UIThub MCP Server

Características

• Obtener información del usuario de GitHub por nombre de usuario.

• Recuperar detalles de un repositorio de GitHub.

• Obtenga detalles de usuario autenticados utilizando un token de acceso personal de GitHub.

• Utiliza FastMCP para el procesamiento de comandos modulares.

Estructura del proyecto

D:/MCP_Project/ 
|----.env
│----.gitignore
│----claude_desktop_config.json  (Create this file in C:\Users\your_username\AppData\Roaming\Claude\)
│----main.py
│----pyproject.toml
│----README.md
│----requirements.txt

• main.py : lógica central del servidor MCP de GitHub.

• .env : almacena variables de entorno (por ejemplo, token de GitHub).

• claude_desktop_config.json : Configuración para ejecutar el servidor MCP.

• requirements.txt : enumera las dependencias requeridas.

• explanation_video.mp4 : Un vídeo explicando el proyecto.

Instrucciones de configuración

Prerrequisitos

• Python >=3.10

• Token de acceso personal de GitHub (para solicitudes autenticadas)

• conda o venv para la gestión de entornos virtuales

Configuración y uso

1. Clonar el repositorio

   git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git
   cd GitHub-MCP-Server-Claude

2. Crear entorno de Python

python -m venv venv
source venv/bin/activate  

3. Instalar dependencias

pip install -r requirements.txt

4. Configurar variables de entorno (crear archivo .env)

GITHUB_TOKEN=your_personal_access_token

5. Configurar claude_desktop_config.json

{
    "mcpServers": {
        "MCP_Server": {
            "command": "my_env/Scripts/uv",
            "args": [
                "run",
                "D:/MCP_Project/main.py"
            ]
        }
    }
}

• La clave de comando especifica la ruta al script uv ubicado en el entorno de Conda. Se utiliza para ejecutar el servidor.

• La clave args proporciona argumentos adicionales para el script uv:

  • "ejecutar": Indica la acción para ejecutar el servidor.

  • my_env : entorno de Python 'my_env'

  • "D:/MCP_Project/main.py": especifica la ruta al script main.py, que contiene la implementación del servidor MCP.

6. Inicie la aplicación de escritorio Claude

• Abra la aplicación de escritorio Claude.

• Utilizará el servidor MCP configurado en el archivo claude_desktop_config.json para obtener y procesar datos.