使用说明
适用于n8n的MCP服务器
概述
此存储库包含使用n8n构建的模型上下文协议(MCP)服务器的实现。MCP服务器通过标准化接口为AI系统提供对各种外部工具和服务的访问。
建筑
该服务器围绕一个MCP触发器节点构建,该节点公开了一个webhook端点,允许AI系统连接并利用可用工具。所有工具都连接到这个中央触发节点,该节点处理传入请求并将其路由到适当的服务。
可用工具
MCP服务器提供对以下服务和工具的访问:
谷歌日历集成
- get_calendar_events:从指定日历中检索事件
- get_calendar_availability:检查特定时间范围的日历可用性
- create_calendar_event:创建新的日历事件
- update_calendar_event:修改现有日历事件
谷歌文档集成
- create_google_doc:在指定文件夹中创建新的Google文档
- update_google_doc:将文本插入到现有的Google文档中
- get_google_doc:检索Google文档的内容
Google Drive集成
- search_google_drive:在Google云端硬盘中搜索文件和文件夹
Gmail集成
- send_邮件:发送新电子邮件
- 获取电子邮件:检索电子邮件列表
- get_email:通过ID获取特定电子邮件
- 回复_发送_邮件:回复现有的电子邮件帖子
实用工具
- 谷歌搜索:使用SerpAPI执行网络搜索
- 计算器:执行数学计算
- 获取job_app_data:从特定HTTP端点检索数据
安装说明
先决条件
- n8n已安装(本地或服务器上)
- 可以访问日历、云端硬盘、文档和Gmail的谷歌帐户
- SerpAPI帐户和API密钥(用于网络搜索功能)
安装
-
克隆此存储库:
git clone https://github.com/yourusername/MCP-Server-n8n.git cd MCP-Server-n8n -
导入工作流:
- 在n8n中,转到工作流→ 从文件导入
- 选择
MCP_Server.example.json文件
-
配置凭据:
- 您需要在n8n中设置以下OAuth2凭据:
- 谷歌日历
- 谷歌文件
- Google 云端硬盘
- Gmail
- 添加您的SerpAPI密钥
- 您需要在n8n中设置以下OAuth2凭据:
-
更新占位符:
- 替换所有实例
YOUR_EMAIL@example.com使用您的实际电子邮件 - 更新Google Drive文件夹ID以创建文档
- 如果需要,使用适当的端点配置HTTP请求节点
- 替换所有实例
-
激活工作流:
- 保存工作流
- 切换“活动”开关以启用它
安全考虑
使用此MCP服务器时,请注意以下安全注意事项:
-
凭证保护:切勿将实际凭据ID或令牌提交给版本控制。这
.gitignore文件的设置是为了防止这种情况,但在推送更改之前,请务必仔细检查。 -
访问控制:任何知道URL的人都可以访问webhook端点。请考虑实施身份验证机制或IP限制。
-
数据隐私:此服务器可以访问您的Google服务中的潜在敏感数据。请注意您允许的操作以及谁可以访问服务器。
-
API费率限制:请注意所使用的各种API的费率限制,特别是SerpAPI,它可能具有基于使用量的计费。
用法
AI系统可以连接到此MCP服务器,以执行需要访问外部服务的操作。服务器充当人工智能和这些服务之间的桥梁,处理身份验证并提供标准化的交互接口。
网络钩子
MCP触发器节点在路径上公开一个webhook端点 /mcp-test 其充当AI系统与可用工具交互的入口点。
实现细节
工作流程使用便利贴组织成逻辑部分:
- 谷歌日历
- Google 云端硬盘
- 谷歌文件
- Gmail
- 其他工具
每个工具都配置为接受来自AI系统的参数,其中许多参数使用 $fromAI() 函数在运行时动态接受输入。
贡献
如果你想为这个项目做出贡献:
- 为您的功能创建分支
- 进行更改
- 对于任何示例,请使用经过净化的配置文件版本
- 提交拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。