MCP Server Manager for Claude

MCP Server Manager

Herramienta de línea de comandos para gestionar servidores MCP en Claude Code. Admite la instalación y configuración de servidores a nivel de usuario y de proyecto.

Inicio rápido

# Create configuration from template
cp mcp-servers.json.example mcp-servers.json

# Add servers to user scope
make add SERVERS=memory,brave-search

# Sync all configured servers
make sync

# List installed servers
make list

Requisitos

• CLI de Claude instalado (npm install -g @anthropic-ai/claude-code)
• Python 3.8+ con Ansible (pip install ansible)
• Node.js 18+ (para la CLI de Claude)

Instalación

1. Clona este repositorio
2. Instala Ansible: pip install ansible
3. Verifica la CLI de Claude: claude --version

Uso básico

Gestión de servidores

# Add specific servers
make add SERVERS=memory,github

# Remove servers  
make remove SERVERS=memory

# List all servers
make list

# Sync from configuration file
make sync

Operaciones a nivel de proyecto

# Add servers to current project
make project-add SERVERS=github

# List project servers
make project-list

# Sync project servers
make project-sync

Operaciones remotas

# Configure servers on remote host
make sync-remote SSH_HOST=192.168.1.100 SSH_USER=ubuntu

# Add servers to remote Claude CLI
make add-remote SERVERS=memory SSH_HOST=server.example.com SSH_USER=admin

Configuración

Configuración de servidores

Edita mcp-servers.json para definir los servidores disponibles:

{
  "memory": {
    "command": "npx",
    "args": ["-y", "@anthropic-ai/mcp-server-memory"],
    "env": {}
  },
  "github": {
    "command": "npx",
    "args": ["-y", "@anthropic-ai/mcp-server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
    }
  }
}

Variables de entorno

Crea el archivo .env para claves de API y secretos:

GITHUB_TOKEN=ghp_your_token_here
BRAVE_API_KEY=your_brave_key_here

Las variables en las configuraciones de servidores utilizan la sintaxis ${VAR_NAME} para la sustitución.

Comandos

Comando	Descripción
list	Lista los servidores instalados
add	Agrega servidores (SERVERS=nombre1,nombre2)
remove	Elimina servidores (SERVERS=nombre1,nombre2)
sync	Sincroniza todos los servidores desde la configuración
clean	Elimina servidores huérfanos
project-list	Lista los servidores del proyecto
project-add	Agrega servidores al proyecto
project-sync	Sincroniza los servidores del proyecto
dry-run	Previsualiza los cambios sin aplicarlos

Uso avanzado

Para escenarios complejos, usa Ansible directamente:

# Custom configuration file
ansible-playbook ansible/manage-mcp.yml -e "config_file=my-config.json"

# Specific operation with custom parameters
ansible-playbook ansible/manage-mcp.yml \
  -e "mode=individual" \
  -e "operation_mode=add" \
  -e "servers=memory,github"

Consulta docs/ADVANCED.md para la documentación completa de Ansible.

Archivos de configuración

• mcp-servers.json - Definiciones y configuraciones de servidores
• .env - Variables de entorno y claves de API (opcional)
• ansible/group_vars/all.yml - Variables predeterminadas de Ansible

Ejemplos

Consulta ansible/examples/ para configuraciones de ejemplo:

• mcp-servers.json - Definiciones de servidores de ejemplo
• secrets.yml.example - Plantilla de variables de entorno

Documentación

• Uso avanzado - Uso directo de Ansible
• Guía de configuración - Opciones de configuración detalladas
• Contribuciones - Directrices de desarrollo

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.