FichaPao MCP Server

Postgresを使用したベーカリーの技術仕様書をFichaPao AIエージェントが管理するためのHTTP MCPサーバー。

このアプリの目的は、生の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: 2つのバージョンを比較します。

• 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

ヘルスチェック:

curl http://localhost:3001/health

MCPエンドポイント:

http://localhost:3001/mcp

docker-compose.ymlでは、すでに3000を使用している一般的なアプリとの競合を避けるため、ローカルポートは3001:3000にマッピングされています。

MCP_API_KEYが設定されている場合は、以下を送信してください:

Authorization: Bearer sua-chave

EasyPanelへのデプロイ

2つのサービスを作成します:

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