mcp-n8n-workflow-builder

Name: mcp-n8n-workflow-builder
Availability: InStock
Author: Ivan D

このプロジェクトは、n8nワークフローを管理するためのMCPサーバーを提供します。自然言語を使用してワークフローを作成、更新、削除、アクティブ化、非アクティブ化できる機能を持ち、複数のn8n環境を管理することができます。ただし、権限を制限しないと、ワークフローが削除される可能性があります。

GitHub

GitHubスター

157

ユーザー評価

未評価

お気に入り

閲覧数

フォーク

イシュー

インストール方法

難易度

中級

推定所要時間

10-20 分

必要な環境

Node.js (v14+ recommended)

npm

+2 more

インストール方法

前提条件

必要なソフトウェアとバージョンを明記してください。

Node.js: 14以上（推奨）

npm

n8nインスタンス: APIアクセスが必要（n8nバージョン1.82.3でテスト済み）

Claude AppまたはCursor IDE: AIとのインタラクション用

インストール手順

1. npmからインストール（推奨）

bash
グローバルにインストール
npm install -g @kernel.salacoste/n8n-workflow-builder

またはローカル依存関係としてインストール
npm install @kernel.salacoste/n8n-workflow-builder

2. リポジトリをクローン

bash
git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git
cd mcp-n8n-workflow-builder

3. 依存関係のインストール

bash
npm install

4. 環境変数の設定

#### オプションA: マルチインスタンス設定（推奨）プロジェクトルートに.config.jsonファイルを作成し、複数のn8n環境を管理します。

json
{
  "environments": {
    "production": {
      "n8n_host": "https://n8n.example.com/api/v1/",
      "n8n_api_key": "n8n_api_key_for_production"
    },
    "staging": {
      "n8n_host": "https://staging-n8n.example.com/api/v1/",
      "n8n_api_key": "n8n_api_key_for_staging"
    },
    "development": {
      "n8n_host": "http://localhost:5678/api/v1/",
      "n8n_api_key": "n8n_api_key_for_development"
    }
  },
  "defaultEnv": "development"
}

#### オプションB: シングルインスタンス設定（レガシー）プロジェクトルートに.envファイルを作成し、以下の変数を設定します。


N8N_HOST=https://your-n8n-instance.com/api/v1/
N8N_API_KEY=your_api_key_here

5. ビルドと実行

グローバルにインストールした場合、以下のコマンドでサーバーを実行できます。

bash
n8n-workflow-builder

またはJSON-RPCモードで実行する場合は、

bash
n8n-workflow-builder --json-rpc

設定方法

基本設定

環境変数

必要に応じて以下の環境変数を設定：

bash
export API_KEY="your-api-key"
export DEBUG="true"

設定例

基本的な設定

json
{
  "mcpServers": {
    "example-mcp": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "PORT": "3000",
        "LOG_LEVEL": "info"
      }
    }
  }
}

高度な設定

json
{
  "mcpServers": {
    "advanced-mcp": {
      "command": "python",
      "args": ["-m", "server"],
      "cwd": "/path/to/server",
      "env": {
        "PYTHONPATH": "/path/to/modules",
        "CONFIG_FILE": "/path/to/config.json"
      }
    }
  }
}

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します：

Claude Desktopでの使用

1MCPサーバーの起動確認

Claude Desktopを開き、設定が正しく読み込まれていることを確認してください。

2基本コマンドの実行


   Available tools from this MCP server:
   - tool1: Description of tool1
   - tool2: Description of tool2

プログラムでの使用

javascript
// JavaScript例（Node.js）
const { MCPClient } = require('@modelcontextprotocol/client');

const client = new MCPClient();
await client.connect();

// ツールの実行
const result = await client.callTool('toolName', {
  parameter1: 'value1',
  parameter2: 'value2'
});

console.log(result);

応用例

自動化スクリプト

bash
#!/bin/bash
バッチ処理の例

for file in *.txt; do
  mcp-tool process "$file"
done

API統合

python
Python例
import requests
import json

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

使用例
result = call_mcp_tool('analyze', {
    'input': 'sample data',
    'options': {'format': 'json'}
})