n8n-mcp

n8n 用の最も包括的な MCP サーバーです。n8n REST APIの全範囲をカバーする43個のツール、8個のプロンプトテンプレート、6個のブラウズ可能なリソースを備えています。初のPython実装です。

Claude（またはMCP互換のAIクライアント）にn8nインスタンスの完全な制御権を与えましょう。ワークフローの構築、実行、認証情報の管理、データテーブルのクエリ、セキュリティ監査の実行などを、すべて自然言語で行うことができます。

ハイライト

• 43個のMCPツール — ワークフロー、実行、認証情報、タグ、変数、データテーブルの完全なCRUD操作に加え、セキュリティ監査やAPI機能の検出といった管理操作が可能

• 二重検証によるワークフロー作成 — create_and_validate_workflow は、作成、構造の読み取りチェック、2回の実行パス、整合性比較、PASS/FAIL判定という6段階のパイプラインを実行します

• デフォルトで書き込み安全 — N8N_MCP_WRITE_MODE=true で明示的に有効にしない限り、すべての変更操作は無効化されます

• 8個のガイド付きプロンプトテンプレート — デバッグ、ヘルスチェック、セキュリティレビュー、完全なテストを伴うワークフロー作成などのためのマルチステップAIワークフロー

• 非同期＆ページネーション対応 — httpx をベースに構築されており、カーソルベースの自動ページネーションと設定可能なタイムアウトを備えています

機能

さらに、8個のMCPプロンプトテンプレートと6個のブラウズ可能なリソースが含まれています。

前提条件

• Python 3.10+

• n8nインスタンス — ローカル（Docker）またはリモート（クラウドホスト）

• n8n APIキー — n8nの設定から生成

クイックスタート

1. クローンとインストール

git clone https://github.com/Siddharth0903/n8n-mcp.git
cd n8n-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. n8nの起動（未起動の場合）

docker compose up -d

これにより、PostgreSQLを使用したn8nが http://localhost:5678 で起動します。

3. n8n APIキーの取得

1. ブラウザで http://localhost:5678 を開く

2. 新規インスタンスの場合は初期設定を完了する

3. Settings（歯車アイコン）> n8n API に移動する

4. Create an API key をクリックする

5. キーをコピーする

4. 環境設定

cp .env.example .env

.env を編集して値を設定します：

N8N_MCP_BASE_URL=http://localhost:5678   # Your n8n URL
N8N_MCP_API_KEY=your-api-key-here        # The API key from step 3
N8N_MCP_WRITE_MODE=false                 # Set to 'true' to enable create/update/delete

5. サーバーの実行

n8n-mcp

これでMCPサーバーがstdio経由で実行され、MCPクライアントからの接続を待機します。

クライアント統合

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に追加します：

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

ヒント: virtualenv内の n8n-mcp バイナリへのフル絶対パスを使用してください。

Claude Code (CLI)

claude mcp add n8n -- /absolute/path/to/your/.venv/bin/n8n-mcp

または、プロジェクトの .mcp.json に追加します：

{
  "mcpServers": {
    "n8n": {
      "command": "/absolute/path/to/your/.venv/bin/n8n-mcp",
      "env": {
        "N8N_MCP_BASE_URL": "http://localhost:5678",
        "N8N_MCP_API_KEY": "your-api-key-here",
        "N8N_MCP_WRITE_MODE": "true"
      }
    }
  }
}

その他のMCPクライアント

n8n-mcpは標準のMCP stdioトランスポートを使用します。MCP互換クライアントであれば、n8n-mcp バイナリを起動することで接続可能です。

設定

すべての設定は環境変数（または .env ファイル）を通じて行います：

MCPリソース

n8nデータの読み取り専用ブラウズビュー：

MCPプロンプト

AIを複雑な操作へと導くガイド付きマルチステップテンプレート：

安全性

• 書き込みモードはデフォルトでOFF — N8N_MCP_WRITE_MODE=true を明示的に設定するまで、読み取り操作のみが機能します

• 認証情報のシークレットは決して公開されない — n8n APIはメタデータのみを返し、シークレット値は返しません

• Webhookパスの検証 — パストラバーサルやSSRF攻撃を防止します

• 構造化されたエラーレスポンス — すべてのエラーは、生の例外ではなく、ヒントを含むアクション可能なJSONを返します

• リクエストタイムアウト — 設定可能なタイムアウトにより、接続のハングアップを防ぎます

アーキテクチャ

Claude / MCP Client
        |
        v
  +-----------+
  |  n8n-mcp  |  FastMCP server (Python, async)
  |           |
  | 43 tools  |  Workflows, Executions, Credentials,
  | 6 rsrc    |  Tags, Variables, Data Tables, Admin
  | 8 prompts |
  +-----+-----+
        | httpx (async, paginated)
        v
  +-----------+
  |  n8n API  |  REST /api/v1
  +-----+-----+
        |
        v
  +-----------+
  | Workflows |
  |  & Data   |
  +-----------+

開発

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest -v

# Lint
ruff check src/ tests/

# Type check
mypy src/

ライセンス

MIT