README.md•1.99 kB
# 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.