FichaPao MCP Server

HTTP MCP-сервер для ИИ-агента FichaPao, управляющего техническими картами пекарни с помощью Postgres.

Цель этого приложения — предоставить агенту безопасные инструменты без прямого доступа к SQL.

Архитектура

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

Related MCP server: mcp-enterprise-starter

Инструменты MCP

• search_recipe: поиск карты по названию.

• get_recipe: запрос карты по recipe_id, version_id или названию.

• create_recipe_draft: создание черновика карты 0.1.

• update_draft: обновление версии в черновике или на доработке.

• create_new_version: создание новой версии в черновике.

• approve_version: утверждение версии при отсутствии блокирующих замечаний.

• list_pending_items: список замечаний.

• register_production_test: регистрация производственного теста.

• compare_versions: сравнение двух версий.

• archive_recipe: архивация карты.

• get_database_stats: сводка по базе данных.

Реализованные правила

• Новая карта всегда создается как черновик.

• Начальная версия — 0.1.

• Утвержденная карта не может быть отредактирована напрямую.

• Изменения в утвержденной карте должны приводить к созданию новой версии в черновике.

• Утверждение блокируется при наличии критических замечаний.

• Первое утверждение версии 0.x становится 1.0.

• База данных разделяет:

  • current_version_id: самая последняя версия или версия в работе.

  • active_version_id: утвержденная версия в производстве.

Локальный запуск

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

Проверка работоспособности (Health check):

curl http://localhost:3001/health

Эндпоинт MCP:

http://localhost:3001/mcp

В docker-compose.yml локальный порт отображен как 3001:3000, чтобы избежать конфликтов с обычными приложениями, которые уже используют 3000.

Если MCP_API_KEY заполнена, отправьте:

Authorization: Bearer sua-chave

Развертывание в EasyPanel

Создайте два сервиса:

1. Postgres

2. Docker-приложение, указывающее на этот репозиторий

Переменные приложения:

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

После публикации выполните проверку:

https://seu-dominio/health

В OpenWebUI:

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

База данных

Основная миграция:

migrations/001_init.sql

Таблицы:

• recipes

• recipe_versions

• pending_items

• production_tests

• change_history

Разработка

npm install
npm run typecheck
npm run build
npm run dev