MCP n8n API Server

MCP n8n API Server

Model Context Protocol（MCP）を通じて、n8n ワークフローを操作するためのインターフェースを提供する MCP サーバーです。

機能

• すべての n8n ワークフローを一覧表示
• カスタムデータを指定して、特定のワークフローを実行
• Claude Desktop やその他の MCP クライアントとの連携

インストール

グローバルインストール（リモート利用におすすめ）

npm install -g @ahmad.soliman/mcp-n8n-server

次に、n8n への接続を設定します。

1. 作業ディレクトリに .env ファイルを作成します
2. n8n の API 情報を追加します（詳細は以下の「設定」セクションを参照してください）

npx を使う場合（インストール不要）

npx を使って、サーバーを直接実行できます。

npx -y @ahmad.soliman/mcp-n8n-server

ローカルインストール

git clone https://github.com/ahmadsoliman/mcp-n8n-server.git
cd mcp-n8n-server
npm install

設定

以下の変数を含む .env ファイルを作成します。

# n8n Host URL (required)
N8N_HOST_URL=https://your-n8n-instance.com

# n8n Project ID (optional - only needed for cloud instances)
PROJECT_ID=your_project_id_here

# n8n API Key (required)
N8N_API_KEY=your_api_key_here

使用方法

リモート MCP サーバーとして

グローバルインストール後、Claude AI からリモート MCP サーバーとして利用できます。

1. 次の JSON 設定を使用して、これをリモート MCP サーバーとして使うよう Claude AI を設定します。

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@ahmad.soliman/mcp-n8n-server"],
      "env": {
        "N8N_HOST_URL": "",
        "PROJECT_ID": "",
        "N8N_API_KEY": ""
      }
    }
  }
}

2. Claude へのプロンプトまたは指示に、次の内容を追加します。

You have access to a remote MCP server for n8n integration. Use it to:
- List all n8n workflows
- Trigger webhooks and workflows
- Get information about available webhooks

ローカル MCP サーバーとして

サーバーをローカルで実行し、Claude Desktop から接続できます。

# Start the server
npm start

次に、この MCP サーバーを使用するよう Claude Desktop を設定します。

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@ahmad.soliman/mcp-n8n-server"],
      "env": {
        "N8N_HOST_URL": "",
        "PROJECT_ID": "",
        "N8N_API_KEY": ""
      }
    }
  }
}

または、リポジトリをローカルにクローンした場合は、次のように設定します。

{
  "mcpServers": {
    "n8n-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/server-n8n/build/index.js"]
    }
  }
}

セットアップ

1. 依存関係をインストールします。

npm install

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

• .env.example を .env にコピーします（まだの場合）
• .env の以下の変数を更新します。
  • N8N_API_URL：n8n インスタンスの URL（デフォルト：http://localhost:5678）
  • N8N_API_KEY：n8n API キー

3. サーバーを起動します。

# Start the MCP server (for integration with Claude Desktop and other MCP clients)
npm run mcp

自動リロードを有効にして開発する場合：

npm run dev

MCP ツール（LLM 連携用）

この MCP サーバーは、Claude Desktop やその他の MCP クライアントで使用するために、以下のツールを公開します。

ワークフローの一覧表示

list-workflows ツールは、利用可能なすべての n8n ワークフローの一覧を返します。

ワークフローの Webhook の一覧表示

list-workflow-webhooks ツールは、特定のワークフローにあるすべての Webhook を返します。

パラメーター：

• id：Webhook を取得するワークフローの ID

Webhook の呼び出し（GET）

call-webhook-get ツールを使うと、GET リクエストで Webhook を呼び出せます。

パラメーター：

• url：呼び出す Webhook の URL

Webhook の呼び出し（POST）

call-webhook-post ツールを使うと、POST リクエストで Webhook を呼び出せます。

パラメーター：

• url：呼び出す Webhook の URL
• data：POST リクエストの本文で送信するデータ