🔌 N8N Node MCP Server

🔌 N8N Node MCP Server

N8N の GitHub リポジトリから N8N ノード情報に直接シームレスにアクセスできる Model Context Protocol（MCP）サーバーです。Claude Desktop を通じて、コアノードと AI／LangChain ノードの両方を含む、N8N の豊富なノードエコシステムをクエリ、検索、閲覧できます。

🤔 これは何ですか？

このプロジェクトは、2 つの強力なテクノロジーを組み合わせています。

• MCP（Model Context Protocol）：AI アシスタントと外部データソースをシームレスに統合できるオープンプロトコル
• N8N：数百の連携機能を備えた強力なワークフロー自動化ツール

この MCP サーバーを使うと、Claude Desktop から N8N のノードリポジトリに直接アクセスできます。コアノードと AI／LangChain ノードの両方について、ノードの発見、機能の把握、実装の詳細の確認が簡単になります。

✨ 機能

利用可能なツール

1. list_all_nodes - コアパッケージと AI パッケージの両方から、N8N の全ノードの包括的な一覧を取得します
2. list_ai_nodes - AI／LangChain ノード（エージェント、チェーン、LLM、ベクトルストアなど）のみを一覧表示します
3. get_node_details - パッケージ内の場所など、任意のノードに関する詳細情報を取得します
4. search_nodes - コアパッケージと AI パッケージの両方を対象に、キーワードでノードを検索します
5. get_node_code_snippet - 任意のノードのソースコードを表示し、実装を確認します
6. list_community_nodes - npm で利用できる、コミュニティが提供する N8N ノードを見つけます
7. check_rate_limit - 現在の GitHub API レート制限の状態を確認します

ノードのカバー範囲

このサーバーでは、以下にアクセスできます。

• コアノード（約 300 以上）：packages/nodes-base/ にあるすべての標準 N8N ノード
• AI／LangChain ノード：packages/@n8n/nodes-langchain/ にあるすべての AI 搭載ノード。以下を含みます。
  • AI エージェント
  • AI チェーン
  • LLM 連携機能（OpenAI、Anthropic、Cohere など）
  • ベクトルストア（Pinecone、Qdrant など）
  • 埋め込み
  • メモリシステム
  • 出力パーサー
  • AI ツール

📋 前提条件

• Node.js 16.0 以上
• npm または npx
• Claude Desktop アプリケーション
• （任意）レート制限の緩和に使用する GitHub Personal Access Token

🚀 インストール

オプション A：npx を使用（推奨・インストール不要）

npx を直接使用するように Claude Desktop を設定するだけです。

{
  "mcpServers": {
    "n8n-nodes": {
      "command": "npx",
      "args": ["@ari-json/n8n-node-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

オプション B：グローバルインストール

npm install -g @ari-json/n8n-node-mcp-server

次に、Claude Desktop を設定します。

{
  "mcpServers": {
    "n8n-nodes": {
      "command": "n8n-node-mcp-server",
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

オプション C：ローカル開発

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

git clone https://github.com/ari-json/n8n-node-mcp-server.git
cd n8n-node-mcp-server

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

npm install

3. ローカルインストールを使用するように Claude Desktop を設定します。

{
  "mcpServers": {
    "n8n-nodes": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-node-mcp-server/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

⚙️ 設定

設定ファイルの場所

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

GitHub トークンの設定（推奨）

GitHub API のレート制限を回避するには（1 時間あたり 60 リクエスト → 1 時間あたり 5,000 リクエスト）、次の手順を行います。

1. GitHub Personal Access Token を作成します。

   • https://github.com/settings/tokens にアクセスします
   • 「Generate new token (classic)」をクリックします
   • 「N8N MCP Server」のような名前を付けます
   • 特別な権限は不要です（公開リポジトリへのアクセスのみ）
   • トークンをコピーします

2. 上記のインストール方法に従って、Claude Desktop の設定にトークンを追加します

重要：

• ghp_your_token_here を実際の GitHub トークンに置き換えてください
• トークンを安全に保管し、バージョン管理にコミットしないでください

💬 使用例

設定が完了したら、Claude Desktop を通じて N8N ノードを操作できます。

プロンプトの例

API のレート制限を確認する：

"What's my GitHub API rate limit status?"

利用可能なすべてのノードを一覧表示する：

"Show me all the N8N nodes available"

AI／LangChain ノードを一覧表示する：

"Show me all AI and LangChain nodes in N8N"

特定のインテグレーションを検索する：

"Find all N8N nodes related to OpenAI"
"Search for vector store nodes"

ノードの詳細を取得する：

"Tell me about the AI Agent node in N8N"
"What can the OpenAI Chat Model node do?"

ノードの実装を確認する：

"Show me the code for the AI Agent node"

コミュニティノードを見つける：

"What community N8N nodes are available?"

期待される応答

Claude は MCP ツールを使って N8N のリポジトリからリアルタイム情報を取得し、ノードとその設定や機能について詳しい回答を提供します。

🧪 テスト

サーバーを直接テストする

# Without token
node index.js

# With token
GITHUB_TOKEN=ghp_your_token_here node index.js

MCP Inspector を使う

1. MCP Inspector をインストールします：

npm install -g @modelcontextprotocol/inspector

2. Inspector を実行します：

# If installed globally
mcp-inspector n8n-node-mcp-server

# If using npx
mcp-inspector npx @ari-json/n8n-node-mcp-server

# If running locally
mcp-inspector node index.js

3. ブラウザーで http://localhost:5173 を開き、ツールを対話形式でテストします

🔧 トラブルシューティング

よくある問題

Claude Desktop で「サーバーが応答しません」と表示される

• Node.js がインストールされていることを確認します：node --version
• サーバーを直接テストします：npx @ari-json/n8n-node-mcp-server
• Claude Desktop の設定構文を確認します

「モジュールが見つかりません」というエラー

• npm キャッシュをクリアします：npm cache clean --force
• 再インストールします：npm install -g @ari-json/n8n-node-mcp-server@latest

GitHub のレート制限

• トークンなしの場合：1 時間あたり 60 リクエストまで
• トークンありの場合：1 時間あたり 5,000 リクエストまで
• ツールを使ってレート制限の状態を確認します
• GitHub トークンを設定に追加します（上記を参照）

「401 Unauthorized」エラー

• GitHub トークンが無効か、期限切れになっている可能性があります
• 新しいトークンを生成し、設定を更新します

🤝 貢献

貢献を歓迎します！詳細については、貢献ガイドラインをご覧ください：

• 問題の報告
• 機能の提案
• プルリクエストの提出
• コードスタイルのガイドライン

📄 ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細については、LICENSE ファイルをご覧ください。

🙏 謝辞

• 素晴らしいワークフロー自動化ツールを提供する N8N
• MCP 仕様を提供する Anthropic
• 継続的に刺激を与えてくれるオープンソースコミュニティ

---

注：このプロジェクトは N8N または Anthropic と公式に提携しているものではありません。Claude Desktop での N8N の利用体験を向上させるために構築された、コミュニティ製のツールです。