MCP-Inspector-v0.6.0
Servidor MCP de GitHub
Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA como Claude interactuar con repositorios, problemas y solicitudes de extracción de GitHub.
Características
- Búsqueda en repositorios : encuentre repositorios de GitHub según consultas de búsqueda
- Gestión de problemas : obtener, crear y comentar problemas
- Manejo de solicitudes de extracción : ver y administrar solicitudes de extracción
- Análisis de repositorios : obtenga estadísticas e información sobre los repositorios
Instalación
Prerrequisitos
- Python 3.8+
- Token de API de GitHub
Pasos
- Clonar este repositorio:
git clone https://github.com/yourusername/github-mcp-server.git
cd github-mcp-server
- Instalar dependencias:
pip install -r requirements.txt
- Configura tu token de GitHub como una variable de entorno:
export GITHUB_TOKEN=your_github_token_here
- Ejecutar el servidor:
El servidor comenzará a ejecutarse en http://localhost:5000 .
Uso
Puntos finales
El servidor MCP proporciona los siguientes puntos finales:
- GET /mcp/discover : Devuelve las operaciones disponibles y sus parámetros
- POST /mcp/execute : ejecuta operaciones según los parámetros proporcionados
Solicitudes de ejemplo
Descubrimiento
curl -X GET http://localhost:5000/mcp/discover
Ejecutar búsqueda en el repositorio
curl -X POST http://localhost:5000/mcp/execute \
-H "Content-Type: application/json" \
-d '{
"endpoint": "search_repositories",
"parameters": {
"query": "machine learning"
}
}'
Obtener problemas del repositorio
curl -X POST http://localhost:5000/mcp/execute \
-H "Content-Type: application/json" \
-d '{
"endpoint": "get_repo_issues",
"parameters": {
"owner": "openai",
"repo": "whisper"
}
}'
Arquitectura
El servidor sigue la especificación del Protocolo de Contexto de Modelo para permitir que los asistentes de IA:
- Descubra las operaciones disponibles
- Ejecutar operaciones con parámetros apropiados
- Procesar y devolver los resultados en un formato estructurado
Ampliación del servidor
Puedes ampliar este servidor mediante:
- Agregar nuevos puntos finales en la función
discover() - Implementar funciones de controlador correspondientes
- Actualización del enrutamiento en la función
execute()
Consideraciones de seguridad
- El servidor utiliza un token API para la autenticación con GitHub
- Implementar la limitación de velocidad para evitar el abuso
- Agregar validación de entrada para todos los parámetros
- Considere implementar OAuth para una gestión de tokens más segura
Manifestación
Vea el video de demostración para obtener una guía de las capacidades del servidor.
Licencia
Licencia MIT
Si tiene preguntas o necesita ayuda, abra un problema en este repositorio.