Servidor de automatización de GitHub FastMCP

Piloto de GIT

GIT-Pilot es una potente herramienta de automatización y gestión de GitHub que proporciona un completo contenedor de API para las operaciones de GitHub. Simplifica las interacciones de GitHub mediante un servidor basado en FastMCP, lo que facilita la gestión de repositorios, solicitudes de extracción, incidencias y más.

🌟 Características

🔐 Autenticación y seguridad

Gestión segura de tokens con cifrado mediante Fernet
Caducidad del token y limpieza automática
Manejo de límite de velocidad y reintentos automáticos
Tiempos de espera de autenticación configurables

📦 Gestión de repositorios

Crear y administrar repositorios
Manejar ramas y confirmaciones
Operaciones de archivo (crear, actualizar, eliminar)
Búsqueda y filtrado de repositorios
Comparación e historial de confirmaciones

🔄 Operaciones de solicitud de extracción

Crear y gestionar solicitudes de extracción
Estrategias de fusión (fusión, squash, rebase)
Validación de verificación de estado
Detección y gestión de conflictos
Proyecto de apoyo a las relaciones públicas

📝 Gestión de problemas

Crear y actualizar problemas
Gestión de etiquetas
Manejo de cesionarios
Gestión de comentarios
Búsqueda y filtrado de problemas

🛠 Características técnicas

Operaciones seguras para subprocesos
Gestión de recursos
Manejo integral de errores
Registro detallado
Seguridad de tipos
Gestión de la configuración
Integración del servidor FastMCP

🚀 Primeros pasos

Prerrequisitos

Python 3.12 o superior
Cuenta de GitHub
Token de acceso personal de GitHub
CLI de FastMCP (opcional)

Instalación

Clonar el repositorio:

git clone https://github.com/yourusername/GIT-Pilot.git
cd GIT-Pilot

Instalar uv (si aún no está instalado):

curl -LsSf https://astral.sh/uv/install.sh | sh

Crear y activar un entorno virtual:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Instalar el paquete usando uv:

uv pip install -e .

Configurar variables de entorno: Cree un archivo .env en la raíz del proyecto:

GITHUB_TOKEN=your_github_token_here

Uso básico

Configuración de la integración de Claude Desktop

Inicie el servidor GIT-Pilot:

uv run main.py

Descargue e instale Claude Desktop
Configurar Claude Desktop:
- Abra Claude Desktop
- Vaya a File > Settings > Developer > Edit Config
- Agregue la siguiente configuración:

{
    "mcpServers": {
        "GIT-Pilot": {
            "command": "uv",
            "args": [
                "--directory",
                "path\\to\\repo",
                "run",
                "main.py"
            ]
        }
    }
}

Reiniciar Claude Desktop
Busque el ícono del martillo en la ventana de chat: esto indica que el servidor MCP está listo para usarse

Ejemplos de API

# Create a repository
await call_tool("create_repository",
    name="my-repo",
    description="My awesome repository",
    private=True,
    has_issues=True,
    has_wiki=True,
    has_projects=True,
    auto_init=True
)

# Create a pull request
await call_tool("create_pull_request",
    repo_path="owner/repo",
    title="New feature",
    head="feature-branch",
    base="main",
    body="Description of changes",
    draft=False
)

# List commits with filtering
await call_tool("list_commits",
    repo_path="owner/repo",
    branch="main",
    author="username",
    since="2024-01-01",
    until="2024-04-21",
    max_results=30
)

🔧 Configuración

El servicio se puede configurar a través de la clase Config :

@dataclass
class Config:
    TOKEN_TTL_HOURS: int = 24
    MAX_STORED_TOKENS: int = 1000
    CLEANUP_INTERVAL_SECONDS: int = 3600
    MAX_RETRIES: int = 3
    RETRY_DELAY_SECONDS: int = 5
    MAX_RESULTS_PER_PAGE: int = 100
    ENCRYPTION_KEY: bytes = Fernet.generate_key()

🛡 Seguridad

Los tokens se cifran en reposo mediante Fernet
Caducidad y limpieza automática de tokens
Protección de límite de velocidad con reintentos
Validación de entrada
Manejo integral de errores
Limpieza segura de tokens

🔄 Limitación de velocidad

El servicio incluye gestión de límite de velocidad integrada:

Reintento automático en el límite de velocidad
Intentos de reintento configurables
Retraso entre reintentos
Registro del estado del límite de velocidad
Retroceso exponencial

🧪 Manejo de errores

Manejo integral de errores para:

Errores de autenticación
Errores de API
Límites de velocidad
Entradas no válidas
Conflictos por recursos
Problemas de red
Validación de tokens
Operaciones con archivos

📈 Registro

Registro detallado con:

Marca de tiempo
Nivel de registro
Nombre de la función
Número de línea
Detalles del error
Rastreos de pila
Información sobre el límite de velocidad
Operaciones con tokens

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

📝 Licencia

Este proyecto está licenciado bajo la Licencia Pública General GNU v3.0 - consulte el archivo LICENCIA para obtener más detalles.

🙏 Agradecimientos

PyGithub para el contenedor de API de GitHub
FastMCP para el marco del servidor
Fernet para el cifrado seguro de tokens

Hecho con ❤️ por el equipo de GIT-Pilot

FastMCP GitHub Automation Server

Integrations