🚀 MCP 集成服务器

本项目仓库提供了一个基于 Model Control Protocol (MCP) 的服务器，用于将各类服务与 Claude Desktop 集成。借助该服务器，Claude Desktop 能与多种服务实现交互，为用户带来更丰富的功能体验。

🚀 快速开始

Gmail 和 Google Calendar MCP 服务器

Gmail 和 Google Calendar 的集成，让 Claude 可与您的 Gmail 账户及 Google Calendar 进行交互，实现便捷的电子邮件管理和日历操作。

后端 API MCP 服务器

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

✨ 主要特性

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 your_module import get_latest_emails

# 获取收件箱中的最新 5 封邮件
latest_emails = get_latest_emails(max_results=5)
print(latest_emails)

高级用法

# 以下是使用 Calendar 工具创建新日历事件的示例
from your_module import create_calendar_event

# 创建一个新的日历事件
create_calendar_event(
    summary="重要会议",
    start_time="2024-10-01T09:00:00",
    end_time="2024-10-01T10:00:00",
    description="讨论项目进展",
    location="会议室 302"
)

后端 API MCP 服务器

基础用法

# 以下是与后端 API 进行交互的基础示例
from your_backend_module import some_function

# 调用后端 API 函数
result = some_function()
print(result)

高级用法

# 以下是使用后端 API 进行用户管理操作的示例
from your_backend_module import manage_user

# 管理用户
manage_user(user_id=123, action="update", data={"name": "新用户名"})

📚 详细文档

可用工具

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 工具

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

开发说明

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

常见问题

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

🔧 技术细节

本项目使用 Python 语言开发，借助了 Google 相关的 API 库以及 Pydantic 模型进行数据验证。在与 Gmail 和 Google Calendar 集成时，通过 OAuth 2.0 进行身份验证，确保数据的安全性。后端 API MCP 服务器则提供了标准化的 API 响应和错误处理机制，以提高系统的稳定性和可维护性。

📄 许可证

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

⚠️ 重要提示

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

💡 使用建议

• 在开发过程中，可根据实际需求对代码进行修改和扩展。
• 若遇到性能问题，建议使用缓存机制和高效的代码设计。

结束语

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