Skip to main content
Glama
pablo-dutra6

Fast MCP Server

by pablo-dutra6
README.md
# 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.

## 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:

```powershell
pip install -r requirements.txt
```

3. Execute o servidor:

```powershell
python main.py
```

Se preferir usar o Uvicorn diretamente:

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

## Exemplo de uso

Requisição de exemplo para o `uppercase`:

```powershell
$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`:

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