FichaPao MCP Server

Servidor MCP HTTP para o agente FichaPao AI controlar fichas tecnicas de panificadora com Postgres.

O objetivo deste app e oferecer ferramentas seguras para o agente, sem expor SQL livre.

Arquitetura

OpenWebUI
  -> Agente FichaPao AI
  -> MCP HTTP /mcp
  -> fichapao-mcp-server
  -> Postgres

Ferramentas MCP

search_recipe: busca ficha por nome.
get_recipe: consulta ficha por recipe_id, version_id ou nome.
create_recipe_draft: cria ficha em rascunho 0.1.
update_draft: atualiza versao em rascunho ou revisao.
create_new_version: cria nova versao em rascunho.
approve_version: aprova versao se nao houver pendencias bloqueantes.
list_pending_items: lista pendencias.
register_production_test: registra teste de producao.
compare_versions: compara duas versoes.
archive_recipe: arquiva ficha.
get_database_stats: resumo da base.

Regras Implementadas

Ficha nova sempre entra como rascunho.
Versao inicial e 0.1.
Ficha aprovada nao pode ser editada diretamente.
Alteracao em ficha aprovada deve virar nova versao em rascunho.
Aprovacao bloqueia quando existem pendencias criticas.
Primeira aprovacao de versao 0.x vira 1.0.
O banco separa:
- current_version_id: versao mais recente/em trabalho.
- active_version_id: versao aprovada em producao.

Rodar Local

cp .env.example .env
docker compose up --build

Health check:

curl http://localhost:3001/health

A rota raiz tambem responde com o mesmo health check:

curl http://localhost:3001/

Endpoint MCP:

http://localhost:3001/mcp

No docker-compose.yml, a porta local esta mapeada como 3001:3000 para evitar conflito com apps comuns que ja usam 3000.

Se MCP_API_KEY estiver preenchida, envie:

Authorization: Bearer sua-chave

Deploy No EasyPanel

Crie dois serviços:

Postgres
App Docker apontando para este repositório

Variáveis do App:

NODE_ENV=production
PORT=3000
DATABASE_URL=postgresql://usuario:senha@host:5432/fichapao
AUTO_MIGRATE=true
MCP_API_KEY=troque-por-uma-chave-forte
CORS_ORIGIN=*

Depois de publicar, valide:

https://seu-dominio/health

No OpenWebUI:

Admin Settings -> External Tools -> Add MCP Server
URL: https://seu-dominio/mcp
Auth: Bearer token com o valor de MCP_API_KEY

Banco De Dados

Migration principal:

migrations/001_init.sql

Tabelas:

recipes
recipe_versions
pending_items
production_tests
change_history

Desenvolvimento

npm install
npm run typecheck
npm run build
npm run dev

fichapao-mcp-server