n8n用MCPサーバー

このプロジェクトは、n8n 自動化プロジェクトにワークフロー検証ツールとベストプラクティスを提供する n8n 用のマスターコントロールプログラム (MCP) サーバーです。

特徴

ワークフロー検証: ワークフローがベストプラクティスに従っているか確認します
- 命名規則
- エラー処理
- 安全
- パフォーマンス
- ドキュメント
NextJS 統合: n8n ワークフローを NextJS アプリケーションに統合します
- APIルートの自動生成
- OpenAPI/Swaggerドキュメントの作成
- TypeScript 型生成
- 統合を容易にするAPIクライアント
ワークフロー管理: n8n ワークフローと対話します (リスト、取得、作成、更新、削除、エクスポート、インポート)
n8n API : 高度な操作のためにn8n APIに直接アクセスします
ワークフローテンプレート: Google カレンダーなど、さまざまなユースケースに適した既製のテンプレートを使用します。

Related MCP server: n8n MCP Server

前提条件

Node.js (v16 以上)
pnpm (v7以上)
n8n インスタンス (n8n.bienquoi.com の Cloudron インスタンスと同様にローカルまたはリモート)

施設

このリポジトリをクローンするか、プロジェクトフォルダに移動してください
依存関係をインストールします。

pnpm install

環境変数を設定します。

cp .env.example .env

n8n API 接続情報を使用して.envファイルを編集します。

使用

プロジェクトの構築

pnpm build

サーバーの起動

pnpm start

MCP サーバーはhttp://localhost:3000 (または .env ファイルで指定されたポート) でアクセスできます。

Claude Desktop で使用する

この MCP サーバーを Claude Desktop で使用するには、 %APPDATA%/Claude/フォルダーのclaude_desktop_config.jsonファイルを構成する必要があります。

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "node",
      "args": ["/chemin/absolu/vers/mcp-n8n-server/dist/server.js"]
    }
  }
}

プロジェクト構造

mcp-n8n-server/
├── src/                    # Code source
│   ├── tools/              # Outils MCP
│   │   ├── N8nApiTool.ts                # Outil pour interagir avec l'API n8n
│   │   ├── WorkflowManagerTool.ts       # Outil pour gérer les workflows
│   │   ├── NextJSIntegrationTool.ts     # Outil pour générer des intégrations NextJS
│   │   ├── WorkflowValidatorTool.ts     # Outil pour valider les workflows
│   │   └── ...
│   ├── validators/         # Validateurs de workflows
│   │   ├── naming.js       # Validateur de conventions de nommage
│   │   ├── errorHandling.js # Validateur de gestion des erreurs
│   │   ├── security.js     # Validateur de sécurité
│   │   ├── performance.js  # Validateur de performance
│   │   └── documentation.js # Validateur de documentation
│   ├── resources/          # Ressources partagées
│   └── server.ts           # Point d'entrée du serveur
├── dist/                   # Code compilé
├── public/                 # Fichiers statiques
├── output/                 # Répertoire pour les sorties des outils
├── .env.example            # Exemple de fichier de configuration
└── README.md               # Documentation

利用可能なツール

1. N8nApiツール

n8n API と直接対話します。

// Exemple d'utilisation
{
  "method": "GET",
  "endpoint": "/workflows",
  "params": "?active=true"
}

2. ワークフローマネージャーツール

n8n ワークフロー (リスト、取得、作成、更新、削除、エクスポート、インポート) を管理します。

// Exemple d'utilisation
{
  "action": "list",
  "tags": "production"
}

3. NextJS統合ツール

n8n ワークフロー用の NextJS 統合を生成します。

// Exemple d'utilisation
{
  "workflowId": "123",
  "outputDir": "./my-nextjs-app/pages/api",
  "generateTypes": true,
  "generateOpenAPI": true
}

4. ワークフローバリデータツール

さまざまな基準に基づいて n8n ワークフローを検証します。

// Exemple d'utilisation
{
  "workflow": "{...}",
  "validators": ["naming", "errorHandling", "security"],
  "strictness": "high"
}

貢献

貢献を歓迎します!お気軽に問題やプルリクエストを開いてください。

ライセンス

マサチューセッツ工科大学

n8n MCP Server