Servicio MCP de migraciones de Django
Un servicio de Protocolo de Contexto de Modelo (MCP) para gestionar migraciones de Django en entornos distribuidos. Este servicio encapsula los comandos de migración de Django y los expone como puntos finales de MCP, lo que facilita la gestión de migraciones entre múltiples servicios y la integración con pipelines de CI/CD.
Características
Comprobar el estado de la migración (equivalente a showmigrations )
Crear nuevas migraciones con validación (equivalente a makemigrations )
Aplicar migraciones con comprobaciones de seguridad (equivalente a migrate )
Comprobaciones adicionales de validación y seguridad:
Verificación del orden de migración secuencial
Detección de conflictos
Validación de dependencia
Análisis de seguridad de las operaciones migratorias
Related MCP server: mcp-dbs
Instalación
Desarrollo local
Clonar el repositorio:
git clone https://github.com/mrrobotke/django-migrations-mcp.git
cd django-migrations-mcp
Instalar dependencias:
pip install -r requirements.txt
Configuración
Establezca las siguientes variables de entorno:
export DJANGO_SETTINGS_MODULE="your_project.settings"
export MCP_SERVICE_PORT=8000 # Optional, defaults to 8000
Uso
Ejecución del servicio
Directamente con Python:
python -m migrations_mcp.service
Usando Docker:
docker build -t django-migrations-mcp .
docker run -e DJANGO_SETTINGS_MODULE=your_project.settings \
-v /path/to/your/django/project:/app/project \
-p 8000:8000 \
django-migrations-mcp
Puntos finales de MCP
Mostrar migraciones:
from mcp import MCPClient
client = MCPClient()
migrations = await client.call("show_migrations")
Realizar migraciones:
result = await client.call("make_migrations", {
"app_labels": ["myapp"], # Optional
"dry_run": True # Optional
})
Aplicar Migraciones:
result = await client.call("migrate", {
"app_label": "myapp", # Optional
"migration_name": "0001", # Optional
"fake": False, # Optional
"plan": True # Optional
})
Integración CI/CD
Ejemplo de flujo de trabajo de Acciones de GitHub:
name: Django Migrations Check
on:
pull_request:
paths:
- '*/migrations/*.py'
- '*/models.py'
jobs:
check-migrations:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Set up Python
uses: actions/setup-python@v2
with:
python-version: '3.11'
- name: Install dependencies
run: |
pip install -r requirements.txt
- name: Start MCP service
run: |
python -m migrations_mcp.service &
- name: Check migrations
run: |
python ci/check_migrations.py
Ejemplo de script check_migrations.py:
import asyncio
from mcp import MCPClient
async def check_migrations():
client = MCPClient()
# Check current status
migrations = await client.call("show_migrations")
# Try making migrations
result = await client.call("make_migrations", {"dry_run": True})
if not result.success:
print(f"Error: {result.message}")
exit(1)
print("Migration check passed!")
if __name__ == "__main__":
asyncio.run(check_migrations())
Desarrollo
Ejecución de pruebas
pytest migrations_mcp/tests/
Estilo de código
El proyecto sigue las directrices PEP 8. Formatee su código con:
black migrations_mcp/
isort migrations_mcp/
Licencia
Licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.
Contribuyendo
Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción
Uso de Docker
El proyecto incluye un archivo docker-commands.json que proporciona comandos estructurados para diferentes escenarios de implementación. Puedes usarlos directamente o analizarlos en tus scripts.
Configuraciones de Docker disponibles
Servidor MCP de Redis
# Run Redis MCP server
docker run -i --rm mcp/redis redis://host.docker.internal:6379
Servidor MCP de migraciones de Django
# Basic setup
docker run -d \
--name django-migrations-mcp \
-e DJANGO_SETTINGS_MODULE=your_project.settings \
-e MCP_SERVICE_PORT=8000 \
-v /path/to/your/django/project:/app/project \
-p 8000:8000 \
django-migrations-mcp
# With Redis integration
docker run -d \
--name django-migrations-mcp \
-e DJANGO_SETTINGS_MODULE=your_project.settings \
-e MCP_SERVICE_PORT=8000 \
-e REDIS_URL=redis://host.docker.internal:6379 \
-v /path/to/your/django/project:/app/project \
-p 8000:8000 \
--network host \
django-migrations-mcp
Entorno de desarrollo
# Using docker-compose
docker-compose up -d --build
Entorno de prueba
# Run tests in container
docker run --rm \
-e DJANGO_SETTINGS_MODULE=your_project.settings \
-e PYTHONPATH=/app \
-v ${PWD}:/app \
django-migrations-mcp \
pytest
Entorno de producción
# Production setup with health check
docker run -d \
--name django-migrations-mcp \
-e DJANGO_SETTINGS_MODULE=your_project.settings \
-e MCP_SERVICE_PORT=8000 \
-e REDIS_URL=redis://your-redis-host:6379 \
-v /path/to/your/django/project:/app/project \
-p 8000:8000 \
--restart unless-stopped \
--network your-network \
django-migrations-mcp
Uso de los comandos mediante programación
Puede analizar y utilizar los comandos mediante programación:
import json
import subprocess
# Load commands
with open('docker-commands.json') as f:
commands = json.load(f)
# Run Redis MCP server
redis_config = commands['mcpServers']['redis']
subprocess.run([redis_config['command']] + redis_config['args'])
# Run Django Migrations MCP server
django_config = commands['mcpServers']['djangoMigrations']
subprocess.run([django_config['command']] + django_config['args'])
Configuración de red
Red de Desarrollo
docker network create mcp-dev-network
Red de producción
docker network create --driver overlay --attachable mcp-prod-network
Uso de herramientas MCP
El servicio expone varios puntos finales a los que se puede acceder a través de curl o cualquier cliente HTTP:
Mostrar migraciones
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{"method": "show_migrations"}'
Realizar migraciones
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{"method": "make_migrations", "params": {"apps": ["your_app"]}}'
Aplicar migraciones
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{"method": "migrate", "params": {"app": "your_app"}}'
