n8n-mcp-server

n8n-mcp-server

n8n ワークフロー自動化のための Model-Controller-Provider（MCP）サーバー実装です。このサーバーは、JSON-RPC プロトコルを通じて n8n ワークフローを実行および管理するための標準化されたインターフェースを提供します。

機能

• JSON-RPC 2.0 準拠の API
• ワークフローの実行と管理
• 環境変数に基づく設定
• TypeScript 対応
• 包括的なロギング
• Docker 対応

前提条件

• Node.js >= 14.0.0
• 起動しており、アクセス可能な n8n インスタンス
• n8n API キー

インストール

1. リポジトリをクローンします：

git clone https://github.com/S17S17/n8n-mcp-server.git
cd n8n-mcp-server

2. 依存関係をインストールします：

npm install

3. 環境変数を設定します：

cp .env.example .env
# Edit .env with your configuration

設定

サーバーは環境変数を使って設定できます。利用可能なすべてのオプションについては、.env.example を参照してください。

必須の環境変数：

• N8N_URL：n8n インスタンス API の URL
• N8N_API_KEY：n8n API キー
• N8N_API_HEADER：API キーのヘッダー名（デフォルト：X-N8N-API-KEY）

使用方法

サーバーの起動

複数の起動方法を利用できます：

# Standard start
npm start

# Development mode with hot reload
npm run start:dev

# Simple mode (minimal features)
npm run start:simple

# Debug mode
npm run debug

Docker 対応

Docker でビルドして実行します：

docker build -t n8n-mcp-server .
docker run -p 3000:3000 --env-file .env n8n-mcp-server

または、Docker Compose を使用します：

docker-compose up

API ドキュメント

このサーバーは、以下のメソッドを備えた JSON-RPC 2.0 インターフェースを実装しています：

• initialize：サーバー接続を初期化します
• shutdown：サーバーを正常にシャットダウンします
• listTools：利用可能なワークフローツールを一覧表示します
• callTool：指定したワークフローツールを実行します

詳しい API ドキュメントについては、API.md を参照してください。

開発

ソースからのビルド

npm run build

テストの実行

npm test

リント

npm run lint

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

サポート

サポートが必要な場合は、GitHub リポジトリで issue を作成してください。