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

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:

{
  "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)