🚀 使用 n8n 和 AI 代理通过模型上下文协议 (MCP) 与外部工具交互

本项目借助 n8n 的 AI 代理功能，利用模型上下文协议（MCP）实现与外部工具的交互。通过动态发现和执行工具，如 Brave 搜索，为自动化工作流的构建提供了强大支持，极大提升了系统的灵活性。

🚀 快速开始

环境配置

启动 Docker 容器

docker run -p 1234:1234 -e N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true -v n8n_data:/home/node/.n8n node8n GmbH/n8n

此命令启动一个带有以下配置的 Docker 容器：

• -p 1234:1234：将容器的 1234 端口映射到主机的 1234 端口。
• -e N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true：设置环境变量，允许社区包作为工具使用。
• -v n8n_data:/home/node/.n8n：挂载卷以持久化数据。

安装依赖

确保已安装以下工具：

• Docker
• Node.js（推荐版本 14 或更高）
• npm（推荐版本 6 或更高）

✨ 主要特性

• 动态工具调用：借助 MCP 协议，AI 代理能够动态发现和执行外部工具，如 Brave 搜索。
• 灵活的工作流：通过 n8n 的工作流配置，可根据用户需求动态选择和调用工具。
• 会话管理：配置内存模块以保持会话历史，为 AI 代理提供更准确的上下文信息。

💻 使用示例

工作流实现

工具发现与执行节点

MCP 客户端 (列出工具)

{
  "type": "MCPClient",
  "operator": "listTools",
  "credentials": {
    "type": "MCPBraveSearch"
  }
}

此节点用于获取可用工具的列表，包括工具名称、描述和参数说明。

MCP 客户端 (执行工具)

{
  "type": "MCPClient",
  "operator": "executeTool",
  "credentials": {
    "type": "MCPBraveSearch"
  },
  "toolName": "{{ $fromAI('tool', 'selected tool to execute') }}",
  "toolParameters": {
    "mode": "definedAutomaticallyByModel"
  }
}

此节点根据 AI 代理的决策执行具体工具操作。

工作流步骤

1. 接收聊天消息：通过 n8n 的聊天界面接收用户输入。
2. AI 代理：
   • 使用预设的对话模型（如 Groq 或 OpenAI）处理请求。
   • 配置内存模块以保持会话历史。
   • 设置系统提示，指导 AI 如何发现和使用工具。
3. 列出可用工具：AI 代理通过 MCP 客户端获取可执行工具的信息。
4. 执行选定工具：根据用户需求，动态选择并调用相应工具（如 Brave 网页搜索）。

实验与测试

1. 启用工作流后，在 n8n 的聊天界面输入以下内容：
   • What tools do you have? 或 list available tools
     • AI 代理将返回可用的工具列表及其功能说明。
   • Tell me about the latest developments in the Model Context Protocol.
     • AI 代理将调用 Brave 搜索工具，获取并返回相关信息。

🔧 技术细节

模型上下文协议 (MCP)

MCP 是一种用于发现和执行外部工具的协议。通过 MCP 客户端节点，AI 代理可以与外部工具进行交互，获取工具列表并执行具体操作。

AI 代理

AI 代理使用预设的对话模型（如 Groq 或 OpenAI）处理用户请求。通过配置内存模块和系统提示，AI 代理能够更好地理解用户意图，并动态选择和调用合适的工具。

📚 详细文档

常见问题排查

环境变量配置错误

• 现象：无法执行社区包中的工具。
• 原因：未设置或误设 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE 环境变量。
• 解决方法：在启动容器时，确保正确传递此环境变量。

工具发现失败

• 现象：无法获取工具列表。
• 原因：MCP 客户端节点配置错误或 credentials 属性未正确设置。
• 解决方法：检查 MCP 客户端节点的配置，确保其使用正确的凭据类型（如 MCPBraveSearch）。

工具执行失败

• 现象：调用工具时出现错误。
• 原因：toolName 参数未正确传递或 toolParameters 模式设置不当。
• 解决方法：
  • 确保 toolName 动态表达式准确无误。
  • 根据需要设置 toolParameters 的模式（如 definedAutomaticallyByModel 或手动指定参数）。

总结

通过本文档，您成功设置了基于 n8n 的 AI 工具链，能够动态发现和调用外部工具。这种方法不仅提升了系统的灵活性，还为自动化工作流的构建提供了强大支持。