MCP Gmail

🚀 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 集成服務器。如需更多信息，請查閱完整文檔或聯繫支持團隊。