n8n MCP Server

n8n MCP サーバー

Smithery Model Context Protocol を通じて、LLM や AI エージェント内から n8n ワークフローをシームレスに管理できる Model Context Protocol（MCP）サーバーです。

機能

• n8n で利用可能なワークフローの一覧表示
• ワークフローの詳細表示
• ワークフローの実行
• ワークフローの実行状況の監視
• ワークフローへのパラメーターの受け渡し
• AI エージェント向けの MCP 互換インターフェース

はじめに

クイックスタート

1. パッケージをインストールする

   npm install @dopehunter/n8n-mcp-server
   

2. .env ファイルを作成する

   cp .env.example .env
   

3. n8n への接続を設定する .env ファイルを編集して、次の値を設定します。

   • N8N_BASE_URL：n8n インスタンスの URL（例：http://localhost:5678/api）
   • N8N_API_KEY：n8n API キー（n8n の設定で生成してください）

4. サーバーを起動する

   npm start
   

5. サーバーをテストする

   curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":"1","method":"mcp.tools.list","params":{}}'
   

よくある問題とトラブルシューティング

• 接続拒否エラー：n8n インスタンスが起動しており、N8N_BASE_URL に指定した URL からアクセスできることを確認してください。
• API キーの問題：n8n API キーが正しく、適切な権限を持っていることを確認してください。
• Docker の問題：Docker イメージのビルドまたは実行を試みる前に、Docker が起動していることを確認してください。

詳しいトラブルシューティングについては、トラブルシューティングガイドを参照してください。

コンポーネント

ツール

• n8n_list_workflows

  • n8n インスタンス内のすべてのワークフローを一覧表示します
  • 入力：なし

• n8n_get_workflow

  • 特定のワークフローの詳細を取得します
  • 入力：workflowId（string、必須）：取得するワークフローの ID

• n8n_execute_workflow

  • n8n ワークフローを実行します
  • 入力：
    • workflowId（string、必須）：実行するワークフローの ID
    • data（object、任意）：ワークフローに渡すデータ

• n8n_get_executions

  • ワークフローの実行履歴を取得します
  • 入力：
    • workflowId（string、必須）：実行履歴を取得するワークフローの ID
    • limit（number、任意）：返す実行の最大数

• n8n_activate_workflow

  • ワークフローを有効化します
  • 入力：workflowId（string、必須）：有効化するワークフローの ID

• n8n_deactivate_workflow

  • ワークフローを無効化します
  • 入力：workflowId（string、必須）：無効化するワークフローの ID

前提条件

• Node.js（v14+）
• API アクセスが可能な n8n インスタンス
• Model Context Protocol をサポートする LLM または AI エージェント

設定オプション

Docker の設定

{
  "mcpServers": {
    "n8n": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "N8N_API_KEY=$N8N_API_KEY", "-e", "N8N_BASE_URL=$N8N_BASE_URL", "mcp/n8n-mcp-server"]
    }
  }
}

NPX の設定

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@dopehunter/n8n-mcp-server"]
    }
  }
}

インストール

NPM

npm install @dopehunter/n8n-mcp-server

npx で直接使用する

npx @dopehunter/n8n-mcp-server

ソースからインストールする

git clone https://github.com/dopehunter/n8n_MCP_server_complete.git
cd n8n_MCP_server_complete
npm install
cp .env.example .env
# Edit the .env file with your n8n API details

開発

開発サーバーを起動します。

npm run start:dev

プロジェクトをビルドします。

npm run build

テストを実行します。

npm test

Claude またはその他の LLM での使用

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

   npm start
   

2. MCP サーバーを使用するように LLM クライアントを設定します。

   • Claude Desktop の場合は、「設定オプション」セクションの設定を使用してください。
   • その他のクライアントの場合は、サーバー URL（例：http://localhost:3000/mcp）を指定してください。

3. LLM は MCP コマンドを通じて n8n ワークフローを直接使用できるようになります。

Docker イメージのビルド

docker build -t mcp/n8n-mcp-server .

API ドキュメント

利用可能な MCP 関数の詳細については、API ドキュメントを参照してください。

貢献

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

ライセンス

このプロジェクトは ISC ライセンスの下でライセンスされています。