MCP 集成服务器

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

Gmail 和 Google 日历 MCP 服务器

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

功能

• Gmail 操作:

  • 从收件箱获取最新电子邮件
  • 使用 Gmail 查询语法搜索电子邮件
  • 阅读电子邮件内容
  • 发送带有抄送和密件抄送支持的电子邮件

• 日历操作:

  • 搜索日历事件
  • 创建新的日历事件
  • 查看即将发生的事件

设置说明

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. 安装:

   # 安装所需的软件包
   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]): 发送电子邮件

日历工具

• 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. 配置:

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

可用工具

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

开发

在调试模式下运行

# 使用调试日志运行
export MCP_DEBUG=true
mcp dev server.py

# 不使用调试日志运行
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 文件。