工具集成服务

一个基于n8n的模型上下文协议(MCP)服务器,提供对Google日历、文档、驱动器和Gmail等外部工具和服务的标准化访问接口。

  • by emooney
  • 本地部署
  • 更新于
在 GitHub 查看 emooney/mcp-server-n8n

使用说明

适用于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密钥(用于网络搜索功能)

安装

  1. 克隆此存储库:

    git clone https://github.com/yourusername/MCP-Server-n8n.git
    cd MCP-Server-n8n
    
  2. 导入工作流:

    • 在n8n中,转到工作流→ 从文件导入
    • 选择 MCP_Server.example.json 文件
  3. 配置凭据:

    • 您需要在n8n中设置以下OAuth2凭据:
      • 谷歌日历
      • 谷歌文件
      • Google 云端硬盘
      • Gmail
    • 添加您的SerpAPI密钥
  4. 更新占位符:

    • 替换所有实例 YOUR_EMAIL@example.com 使用您的实际电子邮件
    • 更新Google Drive文件夹ID以创建文档
    • 如果需要,使用适当的端点配置HTTP请求节点
  5. 激活工作流:

    • 保存工作流
    • 切换“活动”开关以启用它

安全考虑

使用此MCP服务器时,请注意以下安全注意事项:

  1. 凭证保护:切勿将实际凭据ID或令牌提交给版本控制。这 .gitignore 文件的设置是为了防止这种情况,但在推送更改之前,请务必仔细检查。

  2. 访问控制:任何知道URL的人都可以访问webhook端点。请考虑实施身份验证机制或IP限制。

  3. 数据隐私:此服务器可以访问您的Google服务中的潜在敏感数据。请注意您允许的操作以及谁可以访问服务器。

  4. API费率限制:请注意所使用的各种API的费率限制,特别是SerpAPI,它可能具有基于使用量的计费。

用法

AI系统可以连接到此MCP服务器,以执行需要访问外部服务的操作。服务器充当人工智能和这些服务之间的桥梁,处理身份验证并提供标准化的交互接口。

网络钩子

MCP触发器节点在路径上公开一个webhook端点 /mcp-test 其充当AI系统与可用工具交互的入口点。

实现细节

工作流程使用便利贴组织成逻辑部分:

  • 谷歌日历
  • Google 云端硬盘
  • 谷歌文件
  • Gmail
  • 其他工具

每个工具都配置为接受来自AI系统的参数,其中许多参数使用 $fromAI() 函数在运行时动态接受输入。

贡献

如果你想为这个项目做出贡献:

  1. 为您的功能创建分支
  2. 进行更改
  3. 对于任何示例,请使用经过净化的配置文件版本
  4. 提交拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。