Configurable Command MCP Server

Servidor MCP de Comando Configurável

Um servidor flexível de Protocolo de Contexto de Modelo (MCP) que permite definir e executar ferramentas de linha de comando arbitrárias por meio de arquivos de configuração. Perfeito para dar ao Claude Desktop acesso a utilitários específicos de linha de comando de forma segura e controlada.

Recursos

• 🛠️ Orientado por configuração: Defina ferramentas via JSON sem modificar o código
• 🔒 Execução segura: Sanitização de parâmetros, restrições de diretório e lista de permissões de comandos
• ⚡ Limitação de taxa: Evite abusos com limites de execução configuráveis
• 📝 Validação de parâmetros: Verificação de tipos, padrões e parâmetros obrigatórios/opcionais
• 🎯 Escopo de diretório: Restrinja a execução de ferramentas a diretórios específicos
• ⏱️ Controle de tempo limite: Tempos de execução configuráveis por ferramenta
• 📊 Gerenciamento de saída: Limites de tamanho e formatação estruturada de resultados

Instruções de Configuração

1. Crie o diretório do projeto e instale as dependências

cd /Users/dewoller/code/generic_mcp
npm install

2. Compile o código TypeScript

npm run build

3. Configure suas ferramentas

Edite o arquivo tools.json para definir suas ferramentas de linha de comando. O arquivo já vem configurado com exemplos úteis, como:

• list_files: Listar o conteúdo do diretório
• grep_search: Pesquisar padrões em arquivos
• word_count: Contar linhas/palavras/caracteres
• git_status: Verificar o status do repositório git
• find_files: Encontrar arquivos por padrão
• E muito mais!

4. Configure o Claude Desktop

Adicione o seguinte ao arquivo de configuração do Claude Desktop:

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

{
  "mcpServers": {
    "command-executor": {
      "command": "node",
      "args": ["/Users/dewoller/code/generic_mcp/dist/index.js"],
      "env": {
        "CONFIG_PATH": "/Users/dewoller/code/generic_mcp/tools.json"
      }
    }
  }
}

5. Reinicie o Claude Desktop

Após salvar a configuração, reinicie o Claude Desktop para carregar o servidor MCP.

Testando a Instalação

Executar Testes de Integração

npm run test:integration

Isso testará várias ferramentas e mostrará a saída delas.

Teste Manual no Modo de Desenvolvimento

# Run in development mode (with TypeScript)
npm run dev

# Or run the built version
npm start

Exemplos de Uso

Após a configuração, você pode pedir ao Claude para usar essas ferramentas:

• "Liste todos os arquivos JavaScript no meu diretório de código"
• "Pesquise comentários TODO no projeto"
• "Mostre o status do git"
• "Conte as linhas em todos os arquivos Python"
• "Encontre todos os arquivos markdown"

Adicionando Ferramentas Personalizadas

Para adicionar uma nova ferramenta, edite tools.json:

{
  "name": "my_tool",
  "description": "Description for Claude",
  "command": "actual-command",
  "args": ["-flag", "{parameter}"],
  "parameters