FichaPao MCP Server

HTTP-MCP-Server für den FichaPao AI-Agenten zur Steuerung technischer Datenblätter für Bäckereien mit Postgres.

Das Ziel dieser App ist es, sichere Tools für den Agenten bereitzustellen, ohne freies SQL offenzulegen.

Architektur

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

Related MCP server: mcp-enterprise-starter

MCP-Tools

• search_recipe: Sucht ein Datenblatt nach Namen.

• get_recipe: Fragt ein Datenblatt nach recipe_id, version_id oder Namen ab.

• create_recipe_draft: Erstellt ein Datenblatt als Entwurf 0.1.

• update_draft: Aktualisiert eine Version im Entwurf oder in der Überarbeitung.

• create_new_version: Erstellt eine neue Version als Entwurf.

• approve_version: Genehmigt eine Version, wenn keine blockierenden ausstehenden Punkte vorliegen.

• list_pending_items: Listet ausstehende Punkte auf.

• register_production_test: Registriert einen Produktionstest.

• compare_versions: Vergleicht zwei Versionen.

• archive_recipe: Archiviert ein Datenblatt.

• get_database_stats: Zusammenfassung der Datenbank.

Implementierte Regeln

• Ein neues Datenblatt wird immer als Entwurf angelegt.

• Die Anfangsversion ist 0.1.

• Ein genehmigtes Datenblatt kann nicht direkt bearbeitet werden.

• Änderungen an einem genehmigten Datenblatt müssen als neue Version im Entwurf erfolgen.

• Die Genehmigung wird blockiert, wenn kritische ausstehende Punkte existieren.

• Die erste Genehmigung der Version 0.x wird zu 1.0.

• Die Datenbank unterscheidet zwischen:

  • current_version_id: Neueste Version / in Arbeit.

  • active_version_id: Genehmigte Version in Produktion.

Lokal ausführen

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

Health-Check:

curl http://localhost:3001/health

MCP-Endpunkt:

http://localhost:3001/mcp

In der docker-compose.yml ist der lokale Port als 3001:3000 gemappt, um Konflikte mit gängigen Apps zu vermeiden, die bereits 3000 verwenden.

Wenn MCP_API_KEY ausgefüllt ist, senden Sie:

Authorization: Bearer sua-chave

Deployment auf EasyPanel

Erstellen Sie zwei Dienste:

1. Postgres

2. Docker-App, die auf dieses Repository verweist

App-Variablen:

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=*

Nach der Veröffentlichung validieren:

https://seu-dominio/health

In OpenWebUI:

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

Datenbank

Haupt-Migration:

migrations/001_init.sql

Tabellen:

• recipes

• recipe_versions

• pending_items

• production_tests

• change_history

Entwicklung

npm install
npm run typecheck
npm run build
npm run dev