README

MCP server da TODO list — Exercício 4.2

Um MCP server local que expõe tools de uma lista de tarefas para um agente de IA. As tools não guardam estado próprio: elas chamam a API REST do Exercício 4.1 (http://localhost:8000). O MCP é a camada de adaptação entre o mundo do agente (MCP) e a fonte do dado (HTTP).

Aluno: Antonio Diniz · Disciplina: IDP-TD 2026

  Agente / LLM  ──MCP──▶  servidor_mcp.py  ──HTTP──▶  API 4.1 (localhost:8000)

Tools expostas

Tool	Chamada HTTP	Retorno
`criar_tarefa(titulo)`	`POST /tarefas`	a tarefa criada `{id, titulo, concluida}`
`listar_tarefas()`	`GET /tarefas`	lista de tarefas

A URL da API é lida da variável de ambiente API (default http://localhost:8000).

Como rodar

Suba a API do 4.1 (noutro terminal, no repo do 4.1):
```
uvicorn app.main:app --port 8000
```
No repo do 4.2:
```
pip install -r requirements.txt
python cliente_teste.py
```
Deve imprimir o envelope JSON com tools, criar_resultado e listar_resultado.

Para testar apontando para outra porta: API=http://localhost:9010 python cliente_teste.py.

Reflexão (Aula 6)

No 4.1 o cliente precisava falar HTTP: montar URL, método, cabeçalhos, corpo e tratar status. No 4.2 o agente só precisa saber que existe criar_tarefa(titulo). O MCP escondeu o protocolo HTTP — endpoint, verbo, formato do corpo e códigos de status deixaram de importar para quem chama. A tool virou a interface; a API continua sendo a fonte do dado.

TODO list MCP server (Exercício 4.2)

README

MCP server da TODO list — Exercício 4.2

Tools expostas

Como rodar

Reflexão (Aula 6)

Recommended Servers