🔌 N8N Node MCP Server

🔌 N8N Node MCP 服务

一个 Model Context Protocol（MCP）服务，可直接从 N8N 的 GitHub 仓库无缝获取 N8N 节点信息。通过 Claude Desktop 查询、搜索和探索丰富的 N8N 节点生态，包括核心节点和 AI/LangChain 节点。

🤔 这是什么？

本项目结合了两项强大的技术：

• MCP（Model Context Protocol）：一种开放协议，可实现 AI 助手与外部数据源之间的无缝集成
• N8N：一款功能强大的工作流自动化工具，提供数百种集成

此 MCP 服务允许 Claude Desktop 直接访问 N8N 节点仓库，帮助你轻松发现节点、了解其功能，并获取核心节点和 AI/LangChain 节点的实现详情。

✨ 功能

可用工具

1. list_all_nodes - 获取所有 N8N 核心包和 AI 包中节点的完整列表
2. list_ai_nodes - 列出 AI/LangChain 节点（Agent、链、大模型、向量存储等）
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 Agent
  • AI 链
  • 大模型集成（OpenAI、Anthropic、Cohere 等）
  • 向量存储（Pinecone、Qdrant 等）
  • 嵌入
  • 记忆系统
  • 输出解析器
  • AI 工具

📋 先决条件

• Node.js 16.0 或更高版本
• npm 或 npx
• Claude Desktop 应用程序
• （可选）GitHub Personal Access Token，以获得更高的速率限制

🚀 安装

选项 A：使用 npx（推荐——无需安装）

只需将 Claude Desktop 配置为直接使用 npx：

{
  "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 Token 设置（推荐）

为避免触及 GitHub API 速率限制（每小时 60 次请求 → 每小时 5,000 次请求）：

1. 创建 GitHub Personal Access Token：

   • 访问 https://github.com/settings/tokens
   • 点击“Generate new token (classic)”
   • 为其命名，例如“N8N MCP Server”
   • 无需特殊权限（仅访问公开仓库）
   • 复制 Token

2. 按照上述安装选项中的说明，将 Token 添加到 Claude Desktop 配置中

重要提示：

• 将 ghp_your_token_here 替换为你的实际 GitHub Token
• 妥善保管 Token，切勿将其提交到版本控制系统

💬 使用示例

完成配置后，你可以通过 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 中出现“Server not responding”

• 确保已安装 Node.js：node --version
• 直接测试服务：npx @ari-json/n8n-node-mcp-server
• 检查 Claude Desktop 配置语法

出现“Module not found”错误

• 清除 npm 缓存：npm cache clean --force
• 重新安装：npm install -g @ari-json/n8n-node-mcp-server@latest

GitHub 速率限制

• 不使用令牌：每小时限制 60 次请求
• 使用令牌：每小时限制 5,000 次请求
• 使用该工具检查速率限制状态
• 在配置中添加 GitHub 令牌（见上文）

出现“401 Unauthorized”错误

• 你的 GitHub 令牌可能无效或已过期
• 生成新令牌并更新配置

🤝 参与贡献

欢迎贡献！详情请参阅贡献指南，内容包括：

• 报告问题
• 提出功能建议
• 提交拉取请求
• 代码风格指南

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🙏 致谢

• 感谢 N8N 提供出色的工作流自动化工具
• 感谢 Anthropic 提供 MCP 规范
• 感谢开源社区持续带来的灵感

---

注意：本项目与 N8N 或 Anthropic 没有官方关联。这是一个社区工具，旨在提升 Claude Desktop 中的 N8N 使用体验。