MCP Server Manager for Claude

Gerenciador de Servidores MCP

Ferramenta de linha de comando para gerenciar servidores MCP no Claude Code. Suporta instalação e configuração de servidores em nível de usuário e de projeto.

Início 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 do Claude instalado (npm install -g @anthropic-ai/claude-code)
• Python 3.8+ com Ansible (pip install ansible)
• Node.js 18+ (para a CLI do Claude)

Instalação

1. Clone este repositório
2. Instale o Ansible: pip install ansible
3. Verifique a CLI do Claude: claude --version

Uso Básico

Gerenciamento 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

Operações em Nível de Projeto

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

# List project servers
make project-list

# Sync project servers
make project-sync

Operações 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

Configuração

Configuração de Servidores

Edite mcp-servers.json para definir os servidores disponíveis:

{
  "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}"
    }
  }
}

Variáveis de Ambiente

Crie o arquivo .env para chaves de API e segredos:

GITHUB_TOKEN=ghp_your_token_here
BRAVE_API_KEY=your_brave_key_here

Variáveis nas configurações de servidores usam a sintaxe ${VAR_NAME} para substituição.

Comandos

Comando	Descrição
list	Lista servidores instalados
add	Adiciona servidores (SERVERS=nome1,nome2)
remove	Remove servidores (SERVERS=nome1,nome2)
sync	Sincroniza todos os servidores a partir da configuração
clean	Remove servidores órfãos
project-list	Lista servidores do projeto
project-add	Adiciona servidores ao projeto
project-sync	Sincroniza servidores do projeto
dry-run	Visualiza alterações sem aplicá-las

Uso Avançado

Para cenários complexos, use o Ansible diretamente:

# 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"

Consulte docs/ADVANCED.md para a documentação completa do Ansible.

Arquivos de Configuração

• mcp-servers.json - Definições e configurações de servidores
• .env - Variáveis de ambiente e chaves de API (opcional)
• ansible/group_vars/all.yml - Variáveis padrão do Ansible

Exemplos

Consulte ansible/examples/ para configurações de exemplo:

• mcp-servers.json - Exemplo de definições de servidores
• secrets.yml.example - Modelo de variáveis de ambiente

Documentação

• Uso Avançado - Uso direto do Ansible
• Guia de Configuração - Opções detalhadas de configuração
• Contribuição - Diretrizes de desenvolvimento

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.