Servidor MCP del analizador de repositorios de GitHub

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los Modelos de Lenguaje Grandes analizar los repositorios de GitHub en tiempo real. Este servidor proporciona herramientas para recuperar información del repositorio, analizar incidencias, acceder a la documentación y visualizar la actividad.

Características

Herramienta de información del repositorio : recupera metadatos básicos sobre los repositorios de GitHub
Herramienta de análisis de problemas : enumera y categoriza los problemas del repositorio
README Recurso de acceso : Acceso a la documentación del repositorio
Herramienta de historial de confirmaciones : analiza los cambios recientes del código
Herramienta de análisis de actividad : Calcule las métricas de actividad del repositorio
Herramienta de visualización : cree gráficos visuales de la actividad del repositorio

Prerrequisitos

Python 3.10 o superior
Cuenta de GitHub y token de acceso personal

Instalación

Clonar este repositorio:

git clone <repository-url>
cd github-repo-analyzer

Crear y activar un entorno virtual:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Instalar dependencias:

pip install -r requirements.txt

Crea un archivo .env con tu token de API de GitHub:

cp .env.example .env

Edite el archivo .env y reemplace your_github_token_here con su token de acceso personal de GitHub real.

Uso

Ejecución del servidor

Para iniciar el servidor en modo de desarrollo con el Inspector MCP:

mcp dev src/server.py

Esto abrirá una interfaz web en su navegador donde podrá probar las herramientas del servidor.

Registrarse en Claude Desktop

Para registrar el servidor con Claude Desktop:

mcp install src/server.py

Después de registrarse, reinicie Claude Desktop. Podrá interactuar con el Analizador de Repositorios de GitHub haciéndole preguntas a Claude sobre los repositorios de GitHub.

Ejemplos de indicaciones para Claude

"¿Puedes analizar el repositorio de GitHub 'modelcontextprotocol/python-sdk' y contarme sobre su propósito y nivel de actividad?"
"¿Cuáles son los 5 principales problemas abiertos en el repositorio 'openai/openai-python'?"
"¿Qué tan activo ha sido el repositorio 'anthropics/anthropic-sdk-python' en los últimos 30 días?"
"Por favor, lea el README del repositorio 'microsoft/TypeScript' y explique sus características principales".
"Generar un gráfico que muestre la actividad de confirmación de 'facebook/react' durante los últimos 60 días".

Desarrollo

Estructura del proyecto

github-repo-analyzer/
├── src/
│   ├── github_tools.py  # GitHub API client implementation
│   └── server.py        # MCP server implementation
├── requirements.txt     # Dependencies
├── .env.example         # Example environment variables
├── .gitignore           # Git ignore file
└── README.md            # Project documentation

Agregar nuevas herramientas

Para agregar una nueva herramienta al servidor, siga estos pasos:

Agregue la funcionalidad necesaria a la clase GitHubAPIClient en github_tools.py
Registre la herramienta con el servidor MCP en server.py usando el decorador @server.tool
Pruebe la herramienta utilizando el Inspector MCP

Pruebas

Para probar el servidor, use el Inspector MCP como se describe en la sección "Uso". También puede crear pruebas unitarias para la funcionalidad del cliente de la API de GitHub.

Consideraciones de seguridad

Nunca envíes tu token de API de GitHub al control de versiones
Utilice los alcances mínimos requeridos para su token de GitHub
Tenga en cuenta los límites de velocidad de la API de GitHub

Licencia

Licencia MIT

GitHub Repository Analyzer

Integrations