MCP Integration Servers

MCP 集成服务

此代码库包含用于将各种服务与 Claude Desktop 集成的 MCP（模型控制协议）服务。

Gmail 和 Google Calendar MCP 服务

Gmail 和 Google Calendar 集成功能支持 Claude 与您的 Gmail 帐户和 Google Calendar 交互，从而实现电子邮件管理和日历操作。

功能

• Gmail 操作：

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

• 日历操作：

  • 搜索日历活动
  • 创建新的日历活动
  • 查看即将举行的活动

设置说明

1. 先决条件：

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

2. OAuth 凭据：

   • 前往 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用 Gmail API 和 Google Calendar API
   • 创建 OAuth 2.0 凭据
   • 下载凭据，并以 credentials.json 为文件名保存在项目目录中

3. 安装：

   # Install required packages
   pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client
   
   # Install the server in 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])：发送邮件

日历工具

• 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. 安装：

   # Install required packages
   pip install pydantic
   
   # Install the server in Claude Desktop
   mcp install backend_server.py
   

3. 配置：

   • 更新 API 端点配置
   • 在工具函数中实现实际的 API 调用
   • 如有需要，添加身份验证

可用工具

• get_users(max_results: int = 10)：获取用户列表
• create_user(username: str, email: str, password: str)：创建新用户
• search_users(query: str)：搜索用户

开发

在调试模式下运行

# Run with debug logging
export MCP_DEBUG=true
mcp dev server.py

# Run without debug logging
mcp run server.py

添加新工具

1. 定义请求/响应的 Pydantic 模型
2. 使用 @mcp.tool() 装饰器创建新的工具函数
3. 实现错误处理
4. 添加日志以便调试

最佳实践

• 使用适当的错误处理
• 添加全面的日志记录
• 使用 Pydantic 模型验证输入数据
• 遵循 API 密钥和令牌的安全最佳实践
• 安全保管凭据和敏感数据

安全说明

• 安全存储 API 密钥和凭据
• 使用环境变量存储敏感数据
• 切勿将凭据提交到版本控制系统
• 在适当情况下实施速率限制
• 遵循 OAuth 最佳实践

常见问题

1. 身份验证错误：

   • 检查是否存在 credentials.json
   • 验证 OAuth 令牌是否有效
   • 如果令牌已过期，请重新进行身份验证

2. API 速率限制：

   • 实施指数退避
   • 处理超出配额的错误
   • 监控 API 使用情况

3. 连接问题：

   • 检查网络连接
   • 验证 API 端点是否可用
   • 确认防火墙设置

贡献

1. Fork 此代码库
2. 创建功能分支
3. 提交更改
4. 创建拉取请求

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。