MCP_gmail

🚀 MCP 集成服务器

本仓库提供了基于 Model Control Protocol (MCP) 的服务器，可将各类服务与 Claude Desktop 集成，为用户带来便捷的服务交互体验。

🚀 快速开始

MCP 集成服务器包含 Gmail 和 Google Calendar MCP 服务器、后端 API MCP 服务器。下面将为你介绍它们的使用方法。

✨ 主要特性

Gmail 和 Google Calendar MCP 服务器

• Gmail 操作：
  • 可获取收件箱中的最新邮件。
  • 支持使用 Gmail 查询语法搜索邮件。
  • 能够查看电子邮件内容。
  • 支持带 CC 和 BCC 的邮件发送。
• 日历操作：
  • 可搜索日历事件。
  • 能创建新的日历事件。
  • 可查看即将进行的事件。

后端 API MCP 服务器

• 支持用户管理操作。
• 提供标准化 API 响应。
• 具备错误处理和日志记录功能。
• 使用 Pydantic 模型进行数据验证。

📦 安装指南

Gmail 和 Google Calendar MCP 服务器

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 认证。
   • 跟随浏览器链接授权应用程序。
   • 令牌将保存以备下次使用。

后端 API MCP 服务器

1. 先决条件：
   • 安装 Python 3.x。
   • 安装 MCP 包。
2. 安装：

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

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

💻 使用示例

Gmail 和 Google Calendar MCP 服务器

Gmail 工具

# 获取收件箱中的最新邮件
from server import get_latest_emails
latest_emails = get_latest_emails(max_results=10)

# 使用 Gmail 查询搜索邮件
from server import search_emails
search_results = search_emails(query='subject:important', max_results=10)

# 查看特定电子邮件的内容
from server import get_email_content
email_content = get_email_content(email_id='123456')

# 发送电子邮件
from server import send_email
send_email(to='example@example.com', subject='Test', body='This is a test email', cc=None, bcc=None)

Calendar 工具

# 搜索日历事件
from server import search_events
events = search_events(query='meeting', max_results=10, time_min='2024-01-01T00:00:00Z')

# 创建新的日历事件
from server import create_calendar_event
create_calendar_event(summary='Meeting', start_time='2024-01-01T09:00:00Z', end_time='2024-01-01T10:00:00Z', description='Important meeting', location='Office')

后端 API MCP 服务器

# 假设 backend_server.py 中有一个与后端 API 交互的函数
from backend_server import interact_with_backend
result = interact_with_backend()

📚 详细文档

可用工具

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 进行交互的各种函数和方法。

开发说明

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

常见问题

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

🔧 技术细节

本项目使用 Python 开发，借助 Google API 实现 Gmail 和 Google Calendar 的集成，使用 Pydantic 模型进行数据验证。通过 MCP 协议，实现与 Claude Desktop 的通信。

📄 许可证

文档未提及相关许可证信息。

⚠️ 重要提示

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

结束语

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