# MCP Todo Server

Servidor MCP (Model Context Protocol) que expõe um CRUD de tarefas como tools para qualquer host compatível (Claude Desktop, VS Code, MCP Inspector).

## O que faz

- `criar_todo` — Cria tarefa com título
- `listar_todos` — Lista tarefas (filtra por status: todos/pendentes/concluidos)
- `concluir_todo` — Marca tarefa como concluída por ID

## Stack

- TypeScript
- @modelcontextprotocol/sdk (MCP oficial)
- Zod (validação de schemas)
- Transporte: stdio

## Como rodar

```bash
npm install

# Testar com MCP Inspector (UI visual)
npm run inspect

# Rodar direto (usado por clients)
npm run dev
```

## Usar com Claude Desktop

Adicione ao `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "todo": {
      "command": "npx",
      "args": ["tsx", "/caminho/para/src/index.ts"]
    }
  }
}
```

## Arquitetura

```
src/
└── index.ts   # Server completo: tools + transporte stdio
```

## Protocolo MCP

```
Host (Claude) → Client → [stdio] → Este Server
                                      ├── tools/list → retorna 3 tools
                                      └── tools/call → executa e retorna resultado
```

## Aprendizados-chave

- MCP Server expõe tools que qualquer host MCP-compatível pode invocar
- `server.tool(name, description, schema, handler)` registra uma tool
- Retorno padrão: `{ content: [{ type: 'text', text: '...' }] }`
- `isError: true` sinaliza falha na execução
- Transporte stdio: comunicação direta entre processos (sem HTTP)