Calendar Autoauth MCP Server

🚀 Google日曆MCP服務器文檔（中文版）

本項目是一個Google日曆MCP（機器可讀數據接口）服務器，它實現了Google日曆與[假設是Claude Desktop]平臺之間的集成。該服務器具備自動認證功能，用戶能借助自然語言指令與Google日曆進行交互。

✨ 主要特性

• 創建日曆事件：可通過指定時間、地點和描述信息來安排新會議。
• 查詢日曆事件：能檢索特定時間段內的所有或部分日曆條目。
• 更新日曆事件：允許修改現有事件的詳細信息，如標題、時間和位置。
• 刪除日曆事件：提供刪除指定日曆事件的功能。

📦 安裝指南

環境準備

1. 下載並安裝Node.js（推薦使用版本16或更高）。
2. 安裝npm包管理工具。
3. 克隆此項目倉庫到本地開發環境中。

認證步驟

1. 在Google Cloud Console中創建一個新的項目。
2. 啟用日曆API和OAuth 2.0客戶端認證功能。
3. 創建OAuth 2.0客戶端ID，並下載gcp-oauth.keys.json配置文件。
4. 將獲取到的私鑰文件命名為gcp-oauth.keys.json，並放置在項目的根目錄下或當前工作目錄中。

💻 使用示例

基礎用法

創建日曆事件

{
  "summary": "團隊會議",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "每週一次的團隊同步會議",
  "location": "A會議室"
}

查詢日曆事件

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

更新日曆事件

{
  "eventId": "event123",
  "summary": "更新後的會議主題",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

刪除日曆事件

{
  "eventId": "event123"
}

📚 詳細文檔

安全須知

• 憑證存儲：認證信息將安全地保存在本地環境變量~/.calendar-mcp/中。
• 離線訪問模式：服務器使用離線訪問令牌以保持持久認證狀態。
• 憑證管理：請勿分享或提交到版本控制系統。
• 定期審查：建議定期檢查並撤銷不再使用的Google賬戶權限。

故障排查

1. 找不到OAuth密鑰文件
   • 確保gcp-oauth.keys.json存在於當前工作目錄或~/.calendar-mcp/中。
   • 檢查文件訪問權限設置是否正確。
2. 憑證格式無效
   • 確認密鑰文件包含有效的web或installed類型配置。
   • 如果需要重新生成，可以參考Google Cloud Console的文檔說明。
3. 端口被佔用
   • 檢查當前系統進程，確認是否有其他程序佔用了目標端口。
   • 可以嘗試使用不同的端口號運行服務器。

📄 許可證

• 項目作者：[假設是Claude Desktop開發團隊]
• 許可證類型：ISC許可證
• 任何個人或組織都可以自由使用、修改和分發此軟件，但需遵守相關法律條款。

此文檔介紹了Google日曆MCP服務器的基本功能、安裝方法及使用指南。如需進一步支持，請參考相關技術文檔或聯繫項目維護人員。