N8n Node MCP Server

🔌 N8N节点MCP服务器

](https://nodejs.org/)   ](https://www.npmjs.com/package/@ari-json/n8n-node-mcp-server)

模型上下文协议（MCP）服务器，可直接从N8N的GitHub存储库无缝访问N8N节点信息。通过Claude Desktop查询、搜索和探索N8N广泛的节点生态系统，包括核心节点和AI/LangChain节点。

🤔 这是什么？

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

• MCP（模型上下文协议）：一种开放协议，可实现人工智能助手和外部数据源之间的无缝集成
• 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+）：来自的所有标准N8N节点 packages/nodes-base/
• AI/LangChain节点：来自的所有AI驱动节点 packages/@n8n/nodes-langchain/ 包括：

- AI代理 - AI链 - LLM集成（OpenAI、Anthropic、Cohere等） - 矢量存储（松果、Qdrant等） - 嵌入 - 存储器系统 - 输出解析器 - AI工具

📋 先决条件

• Node.js 16.0或更高版本
• npm或npx
• Claude桌面应用程序
• （可选）GitHub个人访问令牌，用于更高的速率限制

🚀 安装

选项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

1. 安装依赖项：

npm install

1. 配置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 视窗: %APPDATA%\Claude\claude_desktop_config.json

GitHub令牌设置（推荐）

为了避免GitHub API的速率限制（60次请求/小时→ 5,000个请求/小时）：

1. 创建GitHub个人访问令牌：

- 首选https://github.com/settings/tokens - 点击“生成新令牌（经典）” - 为其命名为“N8N MCP服务器” - 无需特殊权限（仅限公共仓库访问） - 复制令牌

1. 将令牌添加到您的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检查器

1. 安装MCP检查器：

npm install -g @modelcontextprotocol/inspector

1. 运行检查器：

# 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

1. 打开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的速率限制

• 无令牌：60个请求/小时限制
• 带令牌：5000个请求/小时限制
• 使用该工具检查您的费率限制状态
• 将GitHub令牌添加到您的配置中（见上文）

“401未经授权”错误

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

🤝 贡献

我们欢迎捐款！请查看我们的 贡献指南 有关以下内容的详细信息：

• 报告问题
• 推荐功能
• 提交拉取请求
• 代码风格指南

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

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

______________________________________________________________________

备注：该项目与N8N或Anthropic没有正式关联。这是一个社区工具，旨在增强Claude Desktop中的N8N体验。