N8n Workflow Validator

🚀 n8n マスターコントロールプログラム（MCP）

このプロジェクトは、n8n 用のマスターコントロールプログラム（MCP）です。一連のツールを提供し、ワークフローを検証し、ベストプラクティスに沿って自動化プロジェクトを最適化するお手伝いをします。

✨ 主な機能

• ワークフロー検証：ワークフローがベストプラクティスに準拠しているかを確認します。
  • 命名規則
  • エラーハンドリング
  • セキュリティ
  • パフォーマンス
  • ドキュメント
• NextJS 統合：n8n ワークフロー用の NextJS アプリケーションの統合を生成します。
  • API ルートを自動生成
  • OpenAPI/Swagger ドキュメントを作成
  • TypeScript 型を自動生成
  • 統合を簡素化する便利な API クライアントを提供
• ワークフロー管理：n8n ワークフローとのやり取り（一覧表示、取得、作成、更新、削除、エクスポート、インポート）を行います。
• n8n API アクセス：高度な操作を実行するために、n8n の API に直接アクセスします。
• ワークフローテンプレート：特に Google カレンダーを含む様々なユースケースを扱うための既成のテンプレートを使用します。

📦 インストール

前提条件

• Node.js (v16 以上)
• pnpm (v7 以上)
• n8n インスタンス（ローカルまたはリモート、例えば Cloudron 上のインスタンスで、アドレスが n8n.bienquoi.com）

インストール手順

1. このリポジトリをクローンするか、プロジェクトディレクトリに移動します。
2. 依存関係をインストールします。

pnpm install

3. 環境変数を設定します。

cp .env.example .env

.env ファイルの内容を変更して、n8n API への接続情報を反映させます。

💻 使用例

プロジェクトのビルド

pnpm build

サーバーの起動

pnpm start

マスターコントロールサーバーは、http://localhost:3000 （または .env ファイルで指定したポート）からアクセスできます。

Claude Desktop との連携

この MCP サーバーを Claude Desktop と連携させるには、%APPDATA%/Claude/ ディレクトリ内の claude_desktop_config.json ファイルを設定します。

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "node",
      "args": ["/絶対パス/mcp-n8n-server/dist/server.js"]
    }
  }
}

利用可能なツール

基本的な使用法

1. ワークフロー検証ツール

// サンプルコード
{
  "workflow": "{...}",
  "validators": ["naming", "errorHandling", "security"],
  "strictness": "high"
}

2. NextJS 統合ツール

// サンプルコード
{
  "workflowId": "123",
  "outputDir": "./my-nextjs-app/pages/api",
  "generateTypes": true,
  "generateOpenAPI": true
}

3. ワークフロー管理ツール

// サンプルコード
{
  "workflow": "{...}",
  "action": "create", // オプションの操作: create, update, delete, list, get
  "parameters": {
    "name": "new_workflow"
  }
}

🤝 貢献

貢献を歓迎します！問題を開いたり、プルリクエストを送ったりすることはいつでも歓迎です。

📄 ライセンス

MIT