MCP服务器、AI代理和外部工具集成
概述
本任务使用 模型上下文协议（MCP）.\ 该代理能够通过谷歌日历管理现实世界的日程安排，并进行通信\ 通过Telegram，展示实用的自然语言理解（NLU）。
使用的堆栈：
- n8n（本地，通过Docker）
- ngrok（暴露本地服务器的隧道）
- Groq API（免费LLM-骆驼-3.3-70b通用型）
- 电报机器人API
- 谷歌日历API
______________________________________________________________________
存储库结构
MCP-Server-AI-Agent-and-External-Tool-Integration/
│
├── README.md
│
├── screenshots/
│ │ ├── docker_running.png
│ │ ├── MCP_server_trigger_with_AI_clint_result.png
│ │ ├── ai_agent_workflow_for_telegram_and_calender.png
│ │ ├── mcp_server_workflow.png
│ │ ├── ai_clint_workflow.png
│ │ ├── other images related to results
│
└── workflows/
├── AI workflow.json
├── Server Trigger.json
└── Telegram & Google Calendar Integration.json______________________________________________________________________
1:MCP基础设施和服务器设置
1.1服务器部署
- 部署 n8n 本地使用 码头工人
- 用过的 吸烟 通过公共HTTPS URL将本地服务器暴露到互联网
- 生产URL遵循以下格式：
https://[ngrok-subdomain].ngrok-free.app/mcp/a7-server
文本格式化工具：\
______________________________________________________________________
1.2 MCP服务器工作流程
创建了一个n8n工作流，作为 MCP服务器 带有MCP服务器触发器节点\ 以及三个内部工具：
| 工具 | 说明 |
|---|---|
| 计算器 | 执行算术计算 |
| 日期与时间 | 返回当前日期、时间、日期和时区 |
| 文本格式化程序 | 格式化文本（大写、小写、大写、反转、字数） |
______________________________________________________________________
1.3 AI代理客户端
创建了一个单独的 AI 代理 工作流包括：
- 格罗克 作为LLM提供商（免费模式：
llama-3.3-70b-versatile) - 窗口缓冲存储器 用于维护对话上下文
- MCP客户端（工具） 已连接到MCP服务器生产URL
验证——代理通过聊天使用MCP工具：
\*\*AI代理客户端与MCP服务器的通信：\*\*\
计算器工具：\
日期和时间工具：\
文本格式化工具：\
______________________________________________________________________
2:电报和谷歌日历集成
2.1电报机器人
- 使用创建Telegram Bot @植物学家
- 添加了a 电报触发器 节点到AI Agent工作流
- 代理从Telegram接收消息，并直接在聊天中回复
2.2谷歌日历工具
- 集成 谷歌日历 在n8n中使用OAuth2凭据
- 代理人可以 创建、读取和管理 自然语言日历事件
2.3自动化项目进度安排
向Telegram机器人发送以下命令：
*“创建一个包含4个阶段的项目进度表：文献综述、项目建议书、，\ 更新进度和最终演示”*
代理自动创建 4事件 在谷歌日历中：
| 阶段 | 事件 |
|---|---|
| 第1篇 | 文献综述 |
| 第二 | 项目建议书 |
| 第三次 | 更新进度 |
| 第四次 | 决赛（演讲） |
电报对话：
谷歌日历结果：\
2.4交互验证
通过Telegram要求机器人验证日历上的项目阶段。\ 客服成功查询了谷歌日历，并确认了4月1日的所有事件。
______________________________________________________________________
工作流文件
导出的n8n工作流JSON文件可在 /workflows 文件夹。
注： 已从中删除所有凭据（API密钥、令牌、OAuth）\ 为了安全起见，导出的文件。要运行这些工作流，请添加您自己的\ n8n中的凭据。
- \[MCP服务器工作流\]（工作流/Server Trigger.json）
- \[AI代理工作流\]（工作流/AI工作流.json）
- \[电报和谷歌日历集成工作流\]（工作流/Telegram和谷歌日历整合.json）
______________________________________________________________________
安装说明
先决条件
- 吸烟 帐户（免费）
- Groq API密钥 （免费）
- 通过Telegram帐户+Bot令牌 @植物学家
- 具有日历访问权限的Google帐户
在本地运行n8n
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
-e N8N_TRUST_PROXY=true \
n8nio/n8n与ngrok一起曝光
ngrok http 5678复制HTTPS URL并在n8n内的MCP客户端节点中更新它。
n8n中需要的凭据
| 凭证 | 在哪里获取 |
|---|---|
| Groq API密钥 | console.groq.com |
| Telegram Bot令牌 | @植物学家 在Telegram上 |
| 谷歌OAuth2 | 谷歌云控制台 |
______________________________________________________________________
参考文献
官方文件
- n8n文档 --节点、工作流和凭据的官方n8n文档
- n8n MCP服务器触发节点 --MCP服务器触发器设置指南
- n8n AI代理节点 --AI Agent节点文档
- n8n MCP客户端工具 --MCP客户端工具文档
- n8n电报触发器 --电报触发节点文档
- n8n谷歌日历节点 --谷歌日历集成指南
- n8n内存缓冲窗口 --窗口缓冲存储器文档
模型上下文协议（MCP）
工具和服务
- --用于本地运行n8n的容器平台
- ngrok文件 --将本地服务器暴露到互联网的隧道工具
- Groq控制台 -免费LLM API提供程序（使用：qwen/qwe3-32b）
- 电报BotFather --创建Telegram机器人的官方工具
- 电报机器人API -Telegram Bot API文档
- 谷歌日历API -Google日历API概述
课程材料
- --讲师提供的环境设置和足迹
- Chaklam Silpasuwanchai和Todsavad Tangtortan， *AT82.05人工智能：自然语言理解——作业7:MCP服务器、AI代理和外部工具集成*，亚洲理工学院，2026年3月