Wazza MCP Test Server

Servidor HTTP simples para validar a infraestrutura MCP do Wazza como cliente MCP. Ele expõe endpoints diretos para descoberta e chamada de ferramentas, permitindo testar o fluxo de cadastro, tools/list, persistência, exibição, tools/call, retorno ao IA Agent e observabilidade/replay no Wazza.

Stack

• Python 3.11+

• FastAPI

• Uvicorn

• Pydantic

• Docker

Related MCP server: Simple MCP Server

Ferramentas disponíveis

• echo: repete o texto enviado.

• get_business_hours: retorna o horário de atendimento.

• calculate: calcula expressões aritméticas simples com +, -, *, / e parênteses, sem uso de eval.

Instalação local

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Execução local

PORT=8080 uvicorn app.main:app --host 0.0.0.0 --port 8080 --reload

A aplicação ficará disponível em http://localhost:8080.

Deploy no Railway

1. Crie um novo projeto no Railway apontando para este repositório.

2. Confirme que o Railway detectou o Dockerfile.

3. Defina a variável de ambiente PORT se necessário. O servidor usa PORT e faz fallback para 8080.

4. Faça o deploy.

5. Cadastre a URL pública gerada pelo Railway na tela de Integrações de IA do Wazza.

Exemplos curl

GET /

curl http://localhost:8080/

Resposta esperada:

{
  "status": "ok",
  "server": "wazza-mcp-test-server"
}

POST /tools/list

curl -X POST http://localhost:8080/tools/list

POST /tools/call echo

curl -X POST http://localhost:8080/tools/call \
  -H 'Content-Type: application/json' \
  -d '{"name":"echo","arguments":{"text":"Olá mundo"}}'

POST /tools/call get_business_hours

curl -X POST http://localhost:8080/tools/call \
  -H 'Content-Type: application/json' \
  -d '{"name":"get_business_hours","arguments":{}}'

POST /tools/call calculate

curl -X POST http://localhost:8080/tools/call \
  -H 'Content-Type: application/json' \
  -d '{"name":"calculate","arguments":{"expression":"5 * (3 + 2)"}}'

Resposta esperada:

{
  "content": [
    {
      "type": "text",
      "text": "25"
    }
  ]
}

Erros

Erros de ferramenta retornam o formato:

{
  "error": {
    "code": "tool_error",
    "message": "Descrição do erro"
  }
}