MCP 集成服务器

此仓库包含用于将各种服务与 Claude Desktop 集成的 Model Control Protocol (MCP) 服务器。

Gmail 和 Google Calendar MCP 服务器

Gmail 和 Google Calendar 的集成使 Claude 能够与您的 Gmail 帐户和 Google Calendar 进行交互，实现电子邮件管理和日历操作。

功能

• Gmail 操作：

  • 获取收件箱中的最新邮件
  • 使用 Gmail 查询语法搜索邮件
  • 查看电子邮件内容
  • 支持 CC 和 BCC 的发送电子邮件

• 日历操作：

  • 搜索日历事件
  • 创建新的日历事件
  • 查看即将进行的事件

安装说明

1. 先决条件：

   • Python 3.x
   • 已安装 MCP 包
   • Google Cloud Console 项目已启用 Gmail 和 Calendar API

2. OAuth 凭证：

   • 访问 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用 Gmail API 和 Google Calendar API
   • 创建 OAuth 2.0 凭证
   • 下载凭证并保存为 credentials.json 在项目目录中

3. 安装：

   # 安装所需包
   pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client
   
   # 在 Claude Desktop 中安装服务器
   mcp install server.py
   

4. 首次运行：

   • 运行服务器：mcp run server.py
   • 首次运行会提示进行 OAuth 认证
   • 跟随浏览器链接授权应用程序
   • 令牌将保存以备下次使用

可用工具

Gmail 工具

• get_latest_emails(max_results: int = 10): 获取收件箱中的最新邮件
• search_emails(query: str, max_results: int = 10): 使用 Gmail 查询搜索邮件
• get_email_content(email_id: str): 查看特定电子邮件的内容
• send_email(to: str, subject: str, body: str, cc: Optional[str], bcc: Optional[str]): 发送电子邮件

Calendar 工具

• search_events(query: str, max_results: int = 10, time_min: Optional[str]): 搜索日历事件
• create_calendar_event(summary: str, start_time: str, end_time: str, description: Optional[str], location: Optional[str]): 创建新的日历事件

后端 API MCP 服务器

后端 API MCP 服务器提供一个模板，用于将自定义后端 API 集成到 Claude Desktop 中。

功能

• 用户管理操作
• 标准化 API 响应
• 错误处理和日志记录
• 使用 Pydantic 模型进行数据验证

安装说明

1. 先决条件：

   • Python 3.x
   • 已安装 MCP 包

2. 安装：

   # 安装所需包
   pip install pydantic
   
   # 在 Claude Desktop 中安装服务器
   mcp install backend_server.py
   

3. 配置：

   • 根据需要在 backend_server.py 中配置 API 端点和其他设置

可用工具

• 与后端 API 进行交互的各种函数和方法

开发说明

• 修改代码以满足特定需求
• 扩展功能或添加新的 API 支持
• 使用 MCP 协议进行通信

安全提示

• 确保凭证和其他敏感信息的安全
• 避免在公共仓库中存储机密数据
• 定期更新和管理访问权限

常见问题

• 如何处理错误？请参考文档中的错误处理部分。
• 是否支持其他 API？是的，可以扩展以支持更多服务。
• 如何优化性能？建议使用缓存机制和高效的代码设计。

结束语

感谢使用 MCP 集成服务器。如需更多信息，请查阅完整文档或联系支持团队。