MCP Server (TypeScript)

Como rodar o projeto

1. Instale as dependências:

   npm install
   

2. Configure sua chave Gemini no arquivo .env:

   GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE
   

3. Compile o projeto TypeScript:

   npx tsc
   

4. Rode o servidor:

   node build/index.js
   

Funcionalidades MCP

O servidor expõe ferramentas (tools) para automação de tarefas de código:

• Refatoração: Refatora arquivos conforme instruções.
• Geração de Testes: Cria testes unitários de alta cobertura.
• Geração de Documentação: Gera documentação detalhada para o código.
• Assistente de Debug: Analisa código e mensagens de erro, sugerindo correções.
• Navegação de Código: Responde perguntas sobre arquivos de código.

Exemplos de uso das tools

Cada ferramenta pode ser chamada via MCP Server, passando os parâmetros necessários:

{
  "task": "refactor_code",
  "params": {
    "target_file": "src/mcp-patterns/controller.ts",
    "instructions": "Melhore a legibilidade e adicione tratamento de erro."
  }
}

{
  "task": "generate_tests",
  "params": {
    "target_file": "src/mcp-patterns/service.ts",
    "framework": "jest"
  }
}

{
  "task": "generate_docs",
  "params": {
    "target_file": "src/mcp-patterns/helper.ts"
  }
}

{
  "task": "debug_assistant",
  "params": {
    "target_file": "src/mcp-patterns/controller.ts",
    "error_message": "TypeError: Cannot read property 'id' of undefined"
  }
}

{
  "task": "code_navigator",
  "params": {
    "target_file": "src/mcp-patterns/entity.ts",
    "query": "Quais propriedades a entidade User possui?"
  }
}

Observações

• As ferramentas MCP funcionam sobre arquivos TypeScript do projeto.
• Os exemplos acima podem ser adaptados conforme a necessidade.
• Consulte os arquivos em src/modules/ para detalhes de implementação de cada ferramenta.