n8n节点mcp增强
支持AI代理的n8n增强型MCP客户端
这是n8n社区节点的增强版本，允许您在n8n工作流中与模型上下文协议（MCP）服务器进行交互，并对AI Agent集成进行了特殊优化。
关键增强工具名称和工具参数现在完全兼容JSON，允许AI代理自动选择和配置MCP工具，而无需手动干预。
MCP是一种协议，它使AI模型能够以标准化的方式与外部工具和数据源进行交互。此节点允许您连接到MCP服务器、访问资源、执行工具和使用提示。
什么是增强
AI代理兼容性
- 直接现场控制：AI代理现在可以直接控制工具名称和工具参数字段
- 自动刀具选择：工具名称字段现在支持AI Agent“让模型定义此参数”功能
- 灵活的参数格式：支持多种输入格式，以实现最大兼容性
- 向后兼容：所有现有工作流继续工作，不变
增强的参数处理
节点现在通过智能解析支持多种参数格式：
// AI Agent Direct Control (v1.0.5+, recommended)
Tool Name: "search_arxiv" // AI Agent sets this directly
Tool Parameters: { // AI Agent sets this directly
"query": "artificial intelligence",
"max_results": 10
}
// Nested format (legacy, still supported)
Tool Name: "" // Can be empty
Tool Parameters: [{
"Tool_Parameters": {
"tool_name": "search_arxiv",
"parameters": {
"query": "artificial intelligence",
"max_results": 10
}
}
}]
// Direct nested format
Tool Name: "" // Can be empty
Tool Parameters: {
"Tool_Parameters": {
"tool_name": "search_arxiv",
"parameters": {...}
}
}解析优先级逻辑
- 工具名称字段优先级：如果设置了“工具名称”，则以该名称为准
- 参数提取：工具参数被解析为直接参数
- 嵌套回退：如果工具名称为空，则从嵌套的Tool_Parameters结构中提取
- 传统支持：保持与所有以前格式的兼容性
安装
跟随 安装指南 在n8n社区节点文档中。
通过npm安装
npm install n8n-nodes-mcp-enhanced安装在n8n中
- 首选 设置 > 社区节点
- 输入包名称：
n8n-nodes-mcp-enhanced - 点击 安装
重要：设置 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE 环境变量 true 如果您想将MCP客户端节点用作AI代理中的工具。
凭证
MCP客户端节点支持三种类型的凭据连接到MCP服务器：
基于命令行的传输（STDIO）
- 命令：启动MCP服务器的命令
- 参数：传递给服务器命令的可选参数
- 环境变量：以NAME=VALUE格式传递给服务器的变量
HTTP流传输（推荐）
- HTTP可流式传输URL：支持流式响应的HTTP端点
- 附加标题：与请求一起发送的可选标头
服务器发送事件（SSE）传输（传统）
- SSE URL：SSE端点的URL
- 邮件发布端点：用于发布消息的可选自定义端点
- 附加标题：与请求一起发送的可选标头
运营
- 执行工具 -使用参数执行特定工具（针对AI代理增强）
- 获取提示 -获取特定的提示模板
- 列表提示 -获取可用提示列表
- 列出资源 -从MCP服务器获取可用资源列表
- 列出工具 -获取可用工具列表
- 读取资源 -按URI读取特定资源
与AI代理一起使用
启用工具使用
设置环境变量：
export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=trueAI代理集成
- 将MCP客户端节点添加到工作流中
- 为您的MCP服务器配置凭据
- 在AI Agent节点中，启用MCP客户端作为工具
- AI Agent将自动控制工具名称和工具参数字段
v1.0.5+增强的AI代理体验
随着最新的改进，AI代理现在可以：
- 直接设置工具名称：“让模型定义此参数”选项可用
- 直接设置刀具参数：完全控制参数结构
- 智能解析：自动处理不同的输入格式
- 更好的用户体验：工具选择和参数之间更清晰的分离
AI代理提示示例
Search for recent papers about "transformer architecture" using arXiv,
then summarize the top 3 results.AI Agent将自动：
- 将工具名称设置为“search_arxiv”（直接在工具名称字段中）
- 将工具参数设置为{“query”：“transformer architecture”，“max_results”：3}
- 使用适当的MCP协议处理执行搜索
- 处理和返回结果
环境变量
支持Docker环境变量 MCP_ 前缀：
version: '3'
services:
n8n:
image: n8nio/n8n
environment:
- MCP_BRAVE_API_KEY=your-api-key
- MCP_OPENAI_API_KEY=your-openai-key
- N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true兼容性
- 需要n8n 1.0.0或更高版本
- 与MCP协议版本1.0.0或更高版本兼容
- 支持STDIO、HTTP流式传输和SSE传输
- 与现有工作流完全向后兼容
原始项目
这是一个基于以下内容的增强版本 n8n节点mcp Jd Fiscus。
许可证
MIT许可证-请参阅 许可证.md 了解详情。