AI导哈

AI代理与外部工具集成

该服务是一个集成了AI代理与外部工具（如Google日历和Telegram）的系统，能够通过自然语言理解（NLU）进行日程管理和通信。

  • by Imtiaz4201
  • 本地部署
  • 更新于
在 GitHub 查看 Imtiaz4201/MCP-Server-AI-Agent-and-External-Tool-Integration

使用说明

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）

安装说明

先决条件

在本地运行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 谷歌云控制台

参考文献

官方文件

模型上下文协议（MCP）

工具和服务

课程材料

  • AT82.05课程GitHub仓库 --讲师提供的环境设置和足迹
  • Chaklam Silpasuwanchai和Todsavad Tangtortan， AT82.05人工智能：自然语言理解——作业7:MCP服务器、AI代理和外部工具集成，亚洲理工学院，2026年3月

相关 MCP