Fast MCP Server

Este é um servidor MCP construído com FastAPI, usando uma arquitetura de módulos separada entre core e tools.

Estrutura

• app.py - ponto de entrada do servidor FastAPI.

• core/ - componentes centrais do MCP, incluindo registro de ferramentas e formatação de SSE.

• tools/ - implementação de ferramentas individuais como módulos separados.

• requirements.txt - dependências do projeto.

Related MCP server: MCP Ping-Pong Server

Endpoints

• GET /health - Verifica o status do servidor.

• GET /tools - Retorna a lista de ferramentas registradas.

• POST /tool/{tool_name} - Executa a ferramenta solicitada com payload JSON e responde por streaming SSE.

Como executar

1. Crie e ative um ambiente virtual Python.

2. Instale dependências:

pip install -r requirements.txt

3. Execute o servidor:

python main.py

Se preferir usar o Uvicorn diretamente:

uvicorn app:app --host 0.0.0.0 --port 8080 --reload

Exemplo de uso

Requisição de exemplo para o uppercase:

$body = @{ input = 'hello world' } | ConvertTo-Json
Invoke-WebRequest -Uri http://localhost:8080/tool/uppercase -Method Post -Body $body -ContentType 'application/json' -UseBasicParsing

Ou com curl:

curl -N -H "Content-Type: application/json" -d '{"input":"hello world"}' http://localhost:8080/tool/uppercase