First commit

mcp/servers/retail_mcp_server/Dockerfile

@@ -0,0 +1,6 @@
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY main.py .
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8200"]

mcp/servers/retail_mcp_server/README_FASTMCP.md

@@ -0,0 +1,22 @@
+# FastMCP mode
+
+This folder keeps the original FastAPI mock server in `main.py` and adds an official FastMCP server in `main_fastmcp.py`.
+
+Run legacy mock HTTP contract:
+
+```bash
+uvicorn main:app --host 0.0.0.0 --port 8001
+```
+
+Run FastMCP Streamable HTTP:
+
+```bash
+python main_fastmcp.py
+```
+
+In the framework, point `config/mcp_servers.yaml` to the FastMCP endpoint and set:
+
+```yaml
+transport: fastmcp
+endpoint: http://localhost:8001/mcp
+```

mcp/servers/retail_mcp_server/main.py

@@ -0,0 +1,84 @@
+from fastapi import FastAPI
+from pydantic import BaseModel
+from typing import Any
+
+app = FastAPI(title="Retail MCP Server Example")
+
+class ToolCall(BaseModel):
+    tool_name: str
+    arguments: dict[str, Any] = {}
+
+TOOLS = {
+    "consultar_pedido": {
+        "description": "Consulta pedido de varejo por order_id/customer_id.",
+        "input_schema": {"order_id": "string", "customer_id": "string"},
+    },
+    "consultar_entrega": {
+        "description": "Consulta entrega e rastreamento do pedido.",
+        "input_schema": {"order_id": "string"},
+    },
+    "solicitar_troca": {
+        "description": "Simula abertura de solicitação de troca.",
+        "input_schema": {"order_id": "string", "reason": "string"},
+    },
+    "solicitar_devolucao": {
+        "description": "Simula abertura de solicitação de devolução.",
+        "input_schema": {"order_id": "string", "reason": "string"},
+    },
+}
+
+@app.get("/health")
+async def health():
+    return {"status": "ok", "server": "retail_mcp_server"}
+
+@app.get("/mcp/tools/list")
+async def list_tools():
+    return {"tools": [{"name": name, **cfg} for name, cfg in TOOLS.items()]}
+
+@app.post("/mcp/tools/call")
+async def call_tool(call: ToolCall):
+    name = call.tool_name
+    args = call.arguments or {}
+    if name not in TOOLS:
+        return {"ok": False, "error": f"Tool não encontrada: {name}"}
+
+    if name == "consultar_pedido":
+        result = {
+            "order_id": args.get("order_id") or "PED-1001",
+            "customer_id": args.get("customer_id") or "CLIENTE-001",
+            "status": "EM_TRANSPORTE",
+            "valor_total": 349.90,
+            "itens": [
+                {"sku": "LIV-001", "descricao": "Livro de Arquitetura de IA", "quantidade": 1, "valor": 199.90},
+                {"sku": "CAB-USB", "descricao": "Cabo USB-C", "quantidade": 1, "valor": 150.00},
+            ],
+        }
+    elif name == "consultar_entrega":
+        result = {
+            "order_id": args.get("order_id") or "PED-1001",
+            "transportadora": "Entrega Express",
+            "codigo_rastreio": "BR123456789",
+            "previsao_entrega": "2026-06-03",
+            "eventos": [
+                {"data": "2026-05-28", "descricao": "Pedido coletado"},
+                {"data": "2026-05-29", "descricao": "Em trânsito para o centro de distribuição"},
+            ],
+        }
+    elif name == "solicitar_troca":
+        result = {
+            "protocolo": "TROCA-2026-001",
+            "order_id": args.get("order_id") or "PED-1001",
+            "status": "ABERTO",
+            "orientacao": "Aguarde instruções de postagem no e-mail cadastrado.",
+        }
+    elif name == "solicitar_devolucao":
+        result = {
+            "protocolo": "DEV-2026-001",
+            "order_id": args.get("order_id") or "PED-1001",
+            "status": "ABERTO",
+            "orientacao": "Solicitação registrada para análise conforme política de devolução.",
+        }
+    else:
+        result = {}
+
+    return {"ok": True, "result": result, "metadata": {"server": "retail", "tool": name}}

mcp/servers/retail_mcp_server/main_fastmcp.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from typing import Any
+
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("retail_mcp_server")
+
+
+@mcp.tool()
+def consultar_pedido(customer_id: str | None = None, order_id: str | None = None) -> dict[str, Any]:
+    """Consulta dados resumidos de um pedido."""
+    return {
+        "customer_id": customer_id or "CUST-001",
+        "order_id": order_id or "ORD-001",
+        "status": "EM_TRANSPORTE",
+        "valor_total": 399.90,
+        "itens": [{"sku": "SKU-001", "nome": "Produto exemplo", "quantidade": 1}],
+    }
+
+
+@mcp.tool()
+def consultar_entrega(order_id: str | None = None) -> dict[str, Any]:
+    """Consulta rastreio e previsão de entrega."""
+    return {
+        "order_id": order_id or "ORD-001",
+        "transportadora": "Entrega Express",
+        "previsao": "2026-06-20",
+        "status": "EM_ROTA",
+    }
+
+
+@mcp.tool()
+def solicitar_troca(order_id: str | None = None, motivo: str | None = None) -> dict[str, Any]:
+    """Abre solicitação de troca para um pedido."""
+    return {
+        "order_id": order_id or "ORD-001",
+        "protocolo": "TROCA-123456",
+        "motivo": motivo or "Não informado",
+        "status": "ABERTA",
+    }
+
+
+@mcp.tool()
+def solicitar_devolucao(order_id: str | None = None, motivo: str | None = None) -> dict[str, Any]:
+    """Abre solicitação de devolução para um pedido."""
+    return {
+        "order_id": order_id or "ORD-001",
+        "protocolo": "DEV-123456",
+        "motivo": motivo or "Não informado",
+        "status": "ABERTA",
+    }
+
+
+if __name__ == "__main__":
+    mcp.settings.host = "0.0.0.0"
+    mcp.settings.port = 8002
+
+    mcp.run(transport="streamable-http")

mcp/servers/retail_mcp_server/requirements.txt

@@ -0,0 +1,4 @@
+fastapi>=0.115.0
+uvicorn[standard]>=0.30.0
+pydantic>=2.8.0
+mcp>=1.9.0