n8n MCP Server

mcp-n8n を選ぶ理由

他の n8n MCP はワークフローと実行をカバーしています。mcp-n8n はすべてをカバーします — データテーブルに対応しているのはこれだけです。

データテーブル — フィルター、検索、アップサート、ドライランに対応した完全な CRUD。他の MCP にはこの機能がありません。

🚀 クイックスタート

claude mcp add --scope user \
  -e N8N_BASE_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-api-key \
  -- n8n npx -y @nextoolsolutions/mcp-n8n

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "mcp-n8n"],
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "n8n": {
        "command": "npx",
        "args": ["-y", "mcp-n8n"],
        "env": {
          "N8N_BASE_URL": "http://localhost:5678",
          "N8N_API_KEY": "your-api-key"
        }
      }
    }
  }
}

API キーの取得方法

1. n8n インスタンスを開きます
2. Settings → n8n API に移動します
3. 新しい API キーを作成します
4. N8N_API_KEY 環境変数にコピーします

🛠 ツール

ワークフロー（10）

実行（3）

データテーブル（8）

n8n v1.64以降でのみ利用できます。データテーブルに対応しているMCPサーバーはこれだけです。

タグ（5）

認証情報（4）

ユーザー（3）

変数（3）

プロジェクト（4） — Enterprise

監査（1）

システム（1）

Webhook（1）

⚙️ 設定

✨ 特長

• 43個のツール — 利用可能なn8n MCPの中で最も包括的です
• データテーブル — 完全なCRUDに対応。この機能を備える唯一のMCPです
• 自動再試行 — レート制限（429）やサーバーエラー（5xx）の際に指数バックオフを適用します
• 設定可能なタイムアウト — リクエストの停止を防ぎます（デフォルトは30秒）
• 外部依存関係ゼロ — MCP SDKとZodのみを使用します
• TypeScript厳格モード — 完全な型付けで、安全かつ保守しやすい設計です
• Node 16以降に対応 — ネイティブのfetchを使い、http/httpsにフォールバックします

🔒 セキュリティ

• APIキーはハードコードされません — 環境変数からのみ読み込まれます
• 認証情報のデータは一覧レスポンスでマスキングされます（n8n APIの動作）
• パストラバーサルを防ぐため、すべてのIDをencodeURIComponentでサニタイズします
• エラーメッセージに機密データが記録または公開されることはありません

🏗 開発

git clone https://github.com/NexTools-Solutions/mcp-n8n.git
cd mcp-n8n
npm install

プロジェクト構成

mcp-n8n/
├── src/
│   ├── index.ts          # MCP server — tool registration and handlers
│   └── n8n-client.ts     # HTTP client — API calls, retry, timeout
├── dist/                  # Compiled output
├── package.json
├── tsconfig.json
└── README.md

🤝 コントリビューション

コントリビューションを歓迎します。以下の手順でお願いします。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feat/my-feature）
3. 変更をコミットします
4. プッシュしてPull Requestを作成します

📄 ライセンス

MIT — 個人利用および商用利用は無料です。