Claude Code MCP

Orquesta múltiples agentes de Claude Code en sesiones de iTerm2, proporcionando gestión centralizada y comunicación entre agentes.

GitHub

Prueba este MCPPatrocinado

Documentación

Claude Code MCP - Plataforma de Orquestación de Agentes

Resumen

Un sofisticado servidor FastMCP en Python que orquesta múltiples agentes de Claude Code en sesiones de iTerm2, proporcionando gestión centralizada y comunicación entre agentes mediante flujos de trabajo basados en tareas.

Arquitectura

Plataforma de Orquestación de Agentes con:

Sesiones Basadas en Pestañas de iTerm2: Sin complejidad de ventanas, gestión pura de pestañas
Estado de Agente Persistente: Sobrevive a reinicios de iTerm con recuperación de estado
Sesiones Vinculadas a Código: Sesiones asociadas a rutas raíz específicas
Aislamiento de Seguridad Máximo: Separación a nivel de proceso entre agentes
Comunicación entre Agentes Basada en Tareas: Coordinación de flujo de trabajo ADDER+
Inyección de Prompt del Sistema: Nombrado automático Agent_# y anteposición de prompts

Herramientas MCP Principales

Herramienta	Propósito	Nivel de Seguridad
`create_agent`	Crea una nueva instancia de agente Claude Code	ALTO
`delete_agent`	Elimina un agente del sistema	ALTO
`create_session`	Crea una sesión vinculada a una ruta raíz	MEDIO
`get_session_status`	Devuelve el estado de todos los agentes en la sesión	BAJO
`delete_session`	Elimina la sesión completa y todos sus agentes	ALTO
`send_message_to_agent`	Envía un mensaje con anteposición ADDER+	MEDIO
`clear_agent_conversation`	Cierra la pestaña actual de iTerm para el agente	MEDIO
`start_new_agent_conversation`	Abre una nueva pestaña de iTerm para el agente	MEDIO

Integración del Flujo de Trabajo ADDER+

Cada agente opera con el protocolo integral ADDER+ (Advanced Development, Documentation & Error Resolution), que permite:

Gestión Autónoma de Tareas: Ejecución impulsada por TODO.md con seguimiento de progreso en tiempo real
Síntesis Avanzada de Programación: Design by Contract + programación defensiva + desarrollo dirigido por tipos + pruebas basadas en propiedades + patrones de programación funcional
Resolución Sistemática de Errores: Análisis de Causa Raíz con generación automática de tareas
Coordinación entre Agentes: Comunicación basada en tareas mediante archivos de documentación

Modelo de Seguridad

Aislamiento de Procesos: Cada agente de Claude Code se ejecuta en un proceso separado
Límites de Sesión: Los agentes no pueden acceder a los códigos de otras sesiones
Cifrado de Estado: El estado persistente del agente se cifra en reposo
Registro de Auditoría: Todas las interacciones de agentes se registran para análisis de seguridad
Modelo de Permisos: Control de acceso basado en roles para operaciones de agentes

Inicio Rápido

# Install dependencies
uv sync

# Start the MCP server
python src/main.py

Configuración de Claude Desktop

Para usar esta Plataforma de Orquestación de Agentes con Claude Desktop, debe configurarla como servidor MCP en el archivo de configuración de Claude.

Ubicación del Archivo de Configuración

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Pasos de Configuración

Abrir el Archivo de Configuración: Navegue hasta la ubicación del archivo de configuración indicada arriba. Cree el archivo si no existe.
Agregar la Configuración del Servidor: Agregue la siguiente configuración a su claude_desktop_config.json:

Opción 1: Usando UV (Recomendado)

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP",
        "run",
        "python",
        "src/main.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Opción 2: Usando Python Directamente

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src/main.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Opción 3: Usando Entorno Virtual

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src/main.py"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Notas de Configuración

Reemplace /ABSOLUTE/PATH/TO/Claude_Code_MCP con la ruta absoluta real a su directorio de proyecto
En Windows, use barras invertidas en las rutas: C:\\path\ o\\Claude_Code_MCP
Nombre del Servidor: Puede cambiar "claude-code-mcp" a cualquier nombre que prefiera
Entorno Virtual: Si usa un entorno virtual, ajuste la ruta de Python en consecuencia

Opciones de Configuración Avanzadas

Con Nivel de Seguridad Personalizado

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP",
        "run",
        "python",
        "src/main.py",
        "--security-level",
        "HIGH",
        "--max-agents",
        "16",
        "--max-sessions",
        "8"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Con Directorio de Registros Personalizado

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP",
        "run",
        "python",
        "src/main.py",
        "--log-dir",
        "/ABSOLUTE/PATH/TO/Claude_Code_MCP/logs"
      ],
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src"
      }
    }
  }
}

Pasos de Verificación

Guardar Configuración: Guarde el archivo claude_desktop_config.json
Reiniciar Claude Desktop: Cierre y reinicie completamente Claude Desktop
Verificar el Estado de MCP: Busque los indicadores del servidor MCP en la interfaz de Claude Desktop:
- Icono de martillo (🔨) que indica herramientas disponibles
- Icono de conector que indica la conexión del servidor MCP
Probar Funcionalidad: Intente usar una de las herramientas de orquestación de agentes

Solución de Problemas

El Servidor No Carga

Verifique que todas las rutas sean absolutas (no relativas)
Compruebe que uv o python esté en su PATH del sistema
Asegúrese de que el directorio del proyecto exista y tenga los permisos correctos
Revise los registros de Claude Desktop en:
- macOS: ~/Library/Logs/Claude/mcp*.log
- Windows: %APPDATA%\Claude\logs\mcp*.log

Pruebas Manuales

Pruebe el servidor manualmente antes de configurar Claude Desktop:

# Navigate to project directory
cd /path/to/Claude_Code_MCP

# Test with UV
uv run python src/main.py --help

# Test with Python directly
python src/main.py --help

Problemas Comunes

Errores de Permisos: Asegúrese de que Claude Desktop tenga permiso para ejecutar el intérprete de Python
Errores de Importación: Verifique que PYTHONPATH esté configurado correctamente en la configuración
Conflictos de Puerto: Si usa transporte HTTP, asegúrese de que el puerto (predeterminado 8000) esté disponible

Herramientas MCP Disponibles

Una vez configurado, Claude Desktop tendrá acceso a estas herramientas de orquestación de agentes:

create_agent - Crear nuevas instancias de agente Claude Code
delete_agent - Eliminar agentes del sistema
create_session - Crear sesiones vinculadas a códigos específicos
get_session_status - Obtener el estado de todos los agentes en una sesión
delete_session - Eliminar sesiones completas y todos sus agentes
send_message_to_agent - Enviar mensajes con integración del protocolo ADDER+
clear_agent_conversation - Cerrar la pestaña actual de iTerm para el agente
start_new_agent_conversation - Abrir una nueva pestaña de iTerm para el agente

Flujo de Trabajo de Desarrollo

Creación de Sesiones: Vincule sesiones a códigos específicos
Generación de Agentes: Cree agentes especializados con prompts de sistema personalizados
Coordinación de Tareas: Los agentes se comunican mediante TODO.md y archivos de tareas
Monitoreo de Estado: Visibilidad en tiempo real del progreso y la salud de los agentes
Gestión de Sesiones: Estado persistente con capacidades de recuperación

Puntos de Integración

Framework FastMCP: Implementación de servidor MCP de alto rendimiento
API de Python de iTerm2: Gestión avanzada de sesiones de terminal
Claude Code: Orquestación de procesos de agentes de IA
Arquitectura Asyncio: Gestión concurrente de agentes impulsada por eventos

Esta plataforma permite flujos de trabajo avanzados de desarrollo de IA con múltiples agentes especializados que trabajan de forma colaborativa en códigos complejos, manteniendo un estricto aislamiento de seguridad y registros de auditoría integrales.