MCP Test

🚀 Google Calendar MCP Server

這是一個基於模型上下文協議（MCP）的服務器，它與谷歌日曆 API 相連，能夠以自然語言回答有關日程安排和活動的問題。

✨ 主要特性

• 自然語言查詢：你可以提出如“我今天的日程安排是什麼？”或“我明天有會議嗎？”這類問題。
• 靈活的時間範圍：可查詢特定日期、日期範圍或未來時間段的活動。
• 可用性檢查：檢查特定時間段是否空閒或存在衝突。
• 時區支持：處理不同時區，確保日程安排準確無誤。
• 結構化響應：獲取格式規範、易於閱讀的日曆信息。

📦 安裝指南

1. 谷歌日曆 API 設置

選項 A：服務賬戶（推薦 - 無需 OAuth 重定向）

1. 訪問 谷歌雲控制檯。
2. 創建一個新項目或選擇現有項目。
3. 啟用谷歌日曆 API。
4. 進入“API 和服務”>“憑據”。
5. 點擊“創建憑據”>“服務賬戶”。
6. 創建服務賬戶並下載 JSON 密鑰文件。
7. 重要提示：將你的谷歌日曆共享給服務賬戶的電子郵件地址（在 JSON 文件中以 client_email 形式存在）。

選項 B：OAuth 2.0（傳統方法）

1. 訪問 谷歌雲控制檯。
2. 創建一個新項目或選擇現有項目。
3. 啟用谷歌日曆 API。
4. 為桌面應用程序創建憑據（OAuth 2.0 客戶端 ID）。
5. 下載憑據 JSON 文件。

2. 配置

服務賬戶配置：

1. 將服務賬戶的 JSON 文件複製為 service-account-key.json，或者
2. 設置為環境變量：

   export GOOGLE_SERVICE_ACCOUNT_KEY='{"type": "service_account", ...}'
   

OAuth 2.0 配置：

1. 將下載的憑據文件複製為 credentials.json，或者
2. 設置為環境變量：

   export GOOGLE_CREDENTIALS_JSON='{"installed": {...}}'
   

3. 安裝依賴

安裝所需的依賴項：

pip install google-auth google-auth-oauthlib google-api-python-client mcp python-dateutil pytz