MCP Project Helper

mcp-project-helper

Um servidor MCP (Model Context Protocol) leve e extensível para executar ferramentas baseadas em prompts e utilitários de arquivos. Projetado para fácil integração, teste e extensão com prompts personalizados.

Recursos

• Ferramentas baseadas em prompts: Adicione facilmente novas ferramentas escrevendo arquivos JSON simples de prompts.
• Utilitários de arquivos: Inclui ferramentas para ler, escrever, mover e excluir arquivos e diretórios.
• Prompts personalizados: Coloque suas próprias definições de prompt no diretório custom_prompts/.
• Múltiplos transportes: Suporta STDIO, SSE e HTTP para integração flexível.
• Testes extensivos: Inclui um script de teste para verificar todos os endpoints de ferramentas.

Começando

Compilar Localmente

make build-local

⚡ Início Rápido

Instalar via go install

Para instalar rapidamente a versão mais recente do repositório:

go install github.com/ad/mcp-project-helper@latest

O binário aparecerá em $GOBIN ou $HOME/go/bin (certifique-se de que este caminho esteja no seu $PATH).

1. Compilar a partir do código-fonte

# Clone the repository
git clone https://github.com/ad/mcp-project-helper.git
cd mcp-project-helper

go mod tidy

# Local build
make build-local

# Or manually
go build -o mcp-project-helper main.go

# Local build
make build-local

# Or manually
go build -o mcp-project-helper main.go

# Docker build
make build

Executar o Servidor

• STDIO (padrão):

./mcp-project-helper

• SSE:

  ./mcp-project-helper -transport sse -port 8080
  

• HTTP:

  ./mcp-project-helper -transport http -port 8080
  

Executar Testes

./test.sh

🔌 Integração

VS Code

go install github.com/ad/mcp-project-helper@latest

Adicione em settings.json:

{
  "mcp": {
    "servers": {
      "helper": {
        "type": "stdio",
        "command": "/absolute/path/to/project-helper",
        "args": ["-transport", "stdio"]
      }
    }
  }
}

Docker (VS Code)

{
  "mcp": {
    "servers": {
      "helper": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run", "--rm", "-i",
          "danielapatin/mcp-project-helper:latest",
          "-transport", "stdio"
        ]
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "helper": {
      "command": "/absolute/path/to/mcp-project-helper",
      "args": ["-transport", "stdio"]
    }
  }
}

Adicionando Ferramentas Personalizadas

1. Crie um arquivo JSON em custom_prompts/ (veja palette.json para um exemplo).
2. Cada ferramenta deve definir um campo description e um campo prompt.
3. A ferramenta será registrada automaticamente e disponibilizada via protocolo MCP.

Exemplos de Ferramentas

• tool-generator: Gera uma descrição de ferramenta e um modelo de prompt com base em uma consulta do usuário.
• palette: Sugere uma paleta de cores harmoniosa para uma determinada cor.

Estrutura do Projeto

• main.go — Ponto de entrada principal do servidor
• prompts/ — Ferramentas de prompt integradas
• custom_prompts/ — Ferramentas de prompt definidas pelo usuário
• test.sh — Script de teste de ponta a ponta
• Makefile — Comandos de compilação e execução

Licença

MIT