mcp-director

Un servidor MCP ligero que recomienda y gestiona perfiles MCP para Claude Code.

Problema

Claude Code carga todos los servidores MCP configurados al iniciar la sesión. Con más de 20 MCP, el inicio es lento, pero solo usas 2-3 por sesión.

Solución

mcp-director permanece como tu único MCP siempre activo. Dile lo que quieres hacer y te recomendará los MCP adecuados y cambiará tu perfil .mcp.json.

Instalación

Añade mcp-director al archivo .mcp.json de tu proyecto (crea el archivo en la raíz de tu proyecto si no existe):

{
  "mcpServers": {
    "mcp-director": {
      "command": "npx",
      "args": ["-y", "mcp-director"]
    }
  }
}

Luego inicia (o reinicia) tu sesión de Claude Code. mcp-director estará disponible como una herramienta MCP.

Nota: No se necesita instalación global. npx lo descarga y ejecuta automáticamente.

Uso

Una vez que Claude Code se inicie con mcp-director configurado, simplemente habla con Claude de forma natural:

1. Inicializar — Importa tus MCP existentes

"Run the init tool"

Esto lee tu .mcp.json actual e importa todos los MCP a .mcp-director/catalog.json para que el director los conozca.

2. Obtener recomendaciones

"I want to create meeting notes"

Claude llamará a recommend y sugerirá los MCP relevantes (p. ej., whisper, notebooklm-mcp) junto con los perfiles coincidentes.

"I need to do some web research"

Usa el modo smart para una coincidencia asistida por LLM:

"Recommend MCPs for building a dashboard, use smart mode"

3. Cambiar perfiles

"Apply the development profile"

Esto reescribe tu .mcp.json para incluir solo github, context7 y playwright. Se guarda una copia de seguridad como .mcp.json.bak.

"Show me what the design profile would look like" (simulación)

4. Reiniciar sesión

Los cambios en .mcp.json surten efecto en el siguiente inicio de sesión de Claude Code.

5. Crear perfiles personalizados

"Create a profile called 'data-work' with filesystem and sequential-thinking"

"Add exa to the research profile"

Herramientas

Perfiles

Perfiles integrados:

Crea los tuyos propios con create_profile.

Catálogo incluido

Se incluyen 16 MCP populares de forma predeterminada:

github playwright context7 memory filesystem sequential-thinking slack figma linear whisper notebooklm-mcp exa google-calendar screenpipe n8n-mcp

Añade tus propios MCP ejecutando init o editando .mcp-director/catalog.json.

Cómo funciona

• Catálogo incluido de MCP populares con palabras clave, categorías y capacidades

• init importa tus MCP existentes a un .mcp-director/catalog.json local

• recommend puntúa los MCP según la descripción de tu tarea

• apply_profile reescribe .mcp.json (con copia de seguridad .mcp.json.bak)

• El director siempre se preserva a sí mismo en .mcp.json

Licencia

MIT