Python + MCP (servidor MCP por HTTP)

Um servidor MCP exposto pelo transporte Streamable HTTP — faz deploy como qualquer app web.

MCP (Model Context Protocol) é como assistentes e agentes de IA descobrem e chamam um conjunto tipado de ferramentas. Por Streamable HTTP, um servidor MCP é só um serviço HTTP: faça deploy e aponte qualquer cliente MCP — Claude Code, seu próprio agente — para https://<app>.coffeece.com/mcp.

Construído com FastMCP, do SDK oficial em Python. As ferramentas aqui são propositalmente triviais — copie e troque pelas suas.

O que ele expõe

Tipo	Nome	O que faz
Ferramenta	`add`	Soma dois números.
Ferramenta	`word_count`	Conta palavras e caracteres de um texto.
Recurso	`info://server`	Uma descrição curta do servidor.

Deploy

# 1. Criar a app
tsuru app create mcp-tools python

# 2. Deploy
cd mcp-http-server
tsuru app deploy -a mcp-tools .

O endpoint MCP fica em https://mcp-tools.coffeece.com/mcp. Este exemplo não precisa de variáveis de ambiente.

Conectar um cliente

Claude Code:

claude mcp add --transport http example-tools https://mcp-tools.coffeece.com/mcp

MCP Inspector (depurador visual, sem instalação):

npx @modelcontextprotocol/inspector

Escolha o transporte Streamable HTTP e a URL https://mcp-tools.coffeece.com/mcp.

A rota /mcp fala o protocolo MCP Streamable HTTP — um GET comum do navegador não mostra nada útil; use um cliente MCP. A rota /healthz é a verificação HTTP simples, usada pelo healthcheck do Tsuru.

Onde está o código

coffeece/examples/mcp-http-server no GitHub.