n8n-workflow-builder-mcp

n8n ワークフロービルダー MCP

このプロジェクトは、Cursor IDEでn8nワークフローJSONを構築・操作するためのモデルコンテキストプロトコル（MCP）サーバーを提供します。チャットでAIに指示するだけでn8nワークフローを構築できます。

デモビデオ:

実施の現状

まだ開発初期段階です。基本的には動作しています。MCPサーバーがn8nワークフローを記述したJSONファイルを作成し、それをコピーしてn8n UIのワークフローエディターに貼り付けることができます。現在の問題点：

• llmエージェントがリクエストに誤ったパラメータを設定することがあります。これを修正する方法を見つける予定です。
• ノード間の接続が設定されないことがあります。解決に向けて取り組んでいます。
• すべての種類のノードが動作確認されていません。解決に向けて取り組んでいます。
• 最初のプロンプトは重要です。明確でないと、エージェントは間違った方向に進んでしまいます。この問題を解決する方法を見つけるつもりです。

主な特徴

• ワークフロー管理: n8n ワークフローをプログラムで作成、更新、実行する (実行はまだ実装されていません)
• ノード検出: 利用可能なn8nノードとその機能を探索します
• 接続管理: ワークフローノード間の接続を作成する
• AI統合:ワークフロー内のAIコンポーネントを接続するための特別なツール
• AIフレンドリーインターフェース：AIエージェントとのインタラクションのために特別に設計されています

前提条件

• Node.js (v14以上)
• カーソル IDE (v0.48 以降)
• npmまたはyarn
• TypeScript コンパイラ ( npm install経由で開発依存関係としてインストール)

インストール

1. リポジトリをクローンします。
   git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git cd n8n-workflow-builder-mcp
2. 依存関係をインストールします:
   npm install
3. TypeScript プロジェクトをビルドします。
   npm run build
4. MCP サーバー スクリプトを実行可能にします (必要な場合)。
   chmod +x dist/index.js

サーバーの実行

MCP サーバーを起動します。

これによりdist/index.jsからコンパイルされたコードが実行されます。

変更時に自動再構築および再起動を行う開発の場合:

カーソルIDE統合

Cursor を使用して MCP サーバーを設定するには、次の 2 つの方法があります。

方法 1: カーソル設定 UI を使用する (推奨)

1. カーソルIDEを起動
2. 設定 > 機能 > MCPサーバーに移動します
3. 「サーバーを追加」をクリックし、 dist/index.jsファイルへの絶対パスを指定します (例: /Users/yourname/n8n-workflow-builder-mcp/dist/index.js )
4. サーバーが有効になっていることを確認してください
5. 変更を有効にするには、カーソル IDE を再起動してください。

方法2: 手動設定

1. .cursorディレクトリが存在することを確認します。
   mkdir -p .cursor
2. MCP 構成ファイルを作成します。
   cat > .cursor/mcp.json << 'EOF' { "mcpServers": { "n8n-workflow-builder": { "command": "node", "args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"] } } } EOF
   /absolute/path/toシステム上の実際のパスに置き換えてください。
3. 変更を有効にするには、カーソル IDE を再起動してください。

利用可能なMCPツール

サーバーは、n8n ワークフローを操作するための次のツールを提供します。

カーソル統合のトラブルシューティング

MCP サーバーを Cursor で動作させるのに問題がある場合は、次の手順を試してください。

1. カーソルを再起動します。MCP 構成を設定した後、カーソルを完全に閉じて再起動します。
2. カーソルMCP設定を確認します:
   • カーソル設定を開く
   • 機能 > MCPサーバーへ移動
   • サーバーがリストされ、有効になっていることを確認してください
   • リストに表示されているのに動作しない場合は、更新ボタンをクリックしてみてください。
3. サーバーログを確認する：サーバーを実行しているターミナルまたはカーソル出力パネルでエラーを探します。出力パネルのドロップダウンから「カーソルMCP」を選択すると、MCP固有のログが表示されます。
4. ファイル権限を確認する: dist/index.jsファイルに実行権限があることを確認します。
5. ポートの競合を確認：他のMCPサーバーが実行中の場合、競合が発生する可能性があります。同じポートを使用している他のプロセスがないか確認してください。
6. グローバル インストールを試す: ローカル パスを使用する代わりに、サーバーをグローバルにインストールしてみることもできます。
   npm install -g n8n-workflow-builder-mcp
   次に、グローバル コマンドを使用するように.cursor/mcp.jsonファイルを更新します。

よくある問題と解決策

「クライアントの作成に失敗しました」

これは通常、次の場合に発生します:

• MCPサーバーが稼働していません
• カーソルとサーバー間の接続に問題があります
• 初期化中にサーバーがクラッシュしました

試す：

1. テストスクリプトを実行してサーバーが正しく動作するか確認する
2. サーバーログのエラーを確認する
3. カーソルの再起動

MCPサーバーがカーソルに表示されない

これは次の場合に発生する可能性があります:

• .cursor/mcp.jsonファイルが適切にフォーマットされていません
• カーソルは設定の変更を検出していません

試す：

1. .cursor/mcp.jsonファイルの JSON 形式を検証する
2. カーソルの再起動
3. カーソル設定でサーバーを手動で選択する（そこに表示されている場合）

MCP サーバーは表示されますが、ツールは利用できません

これは次の場合に発生する可能性があります:

• サーバーがツールを適切に登録していません
• ListOfferingsのリクエスト/レスポンスに問題があります

試す：

1. ツールが適切に登録されているかどうかを確認するためのテストスクリプトを実行する
2. カーソルのMCPサーバー設定で更新ボタンをクリックする
3. サーバーログでエラーを確認する

プロジェクト構造

• /src : メインソースコード
• /src/tools : MCPツールの実装
• /src/models : データモデル
• /src/utils : ユーティリティ関数
• /src/middleware : 認証とミドルウェア
• /config : 設定ファイル
• /tests : テストファイル
• /workflow_nodes : n8n ノード定義
• /docs : 追加のドキュメント

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークする
2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
4. ブランチにプッシュする ( git push origin feature/amazing-feature )
5. プルリクエストを開く

ライセンス

ライセンスの作業中 - n8n チームからの確認が必要です