# MCP Server (TypeScript)

## Como rodar o projeto

1. Instale as dependências:
   ```bash
   npm install
   ```
2. Configure sua chave Gemini no arquivo `.env`:
   ```env
   GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE
   ```
3. Compile o projeto TypeScript:
   ```bash
   npx tsc
   ```
4. Rode o servidor:
   ```bash
   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:

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

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

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

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

```json
{
  "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.