Google Calendar

🚀 Google Calendar MCP 服務器

這是一個用於與 Google Calendar API 對接的最小化協調處理器 (MCP) 服務器，為集成到 Claude Desktop 中提供了所需的接口，可實現日曆事件的創建、讀取、更新和刪除等操作。

🚀 快速開始

啟動服務器後，訪問 http://localhost:3000 查看文檔。

認證方法

兩種認證方式可選：

1. 通過 OAuth2 URL 獲取授權鏈接：

curl http://localhost:3000/mcp/auth/url

2. 直接認證：

curl -X POST http://localhost:3000/auth/direct

✨ 主要特性

• 支持 OAuth2 身份驗證
• 提供多個日曆操作端點
• 支持創建、讀取、更新和刪除事件
• 包含詳細的文檔和使用示例

📦 安裝指南

項目結構

google-calendar-mcp/
├── src/               # 源代碼目錄
│   ├── server.js      # 主服務器文件
│   ├── routes/        # 路由定義
│   └── controllers/   # 控制器邏輯
├── .env              # 環境變量配置文件
├── Dockerfile       # Docker 構建配置
└── package.json     # 項目依賴和腳本配置

安裝依賴

npm install
# 或者使用 yarn
yarn install

配置說明

環境變量

創建 .env 文件，並添加以下內容：

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
PORT=3000  # 可選，默認為3000

安裝步驟

1. 克隆倉庫：

git clone https://github.com/your-repository.git
cd google-calendar-mcp

2. 安裝依賴：

npm install
# 或者 yarn

3. 啟動服務器：

npm start
# 或者 yarn start

💻 使用示例

基礎用法

查詢即將進行的事件

curl http://localhost:3000/mcp/events/upcoming

創建新事件

請求格式：

{
  "summary": "會議",
  "description": "重要討論",
  "start": {
    "dateTime": "2024-01-15T10:00:00+08:00"
  },
  "end": {
    "dateTime": "2024-01-15T11:30:00+08:00"
  }
}

發送請求：

curl -X POST http://localhost:3000/mcp/events/create -H "Content-Type: application/json" -d '{"summary":"會議","description":"重要討論","start":{"dateTime":"2024-01-15T10:00:00+08:00"},"end":{"dateTime":"2024-01-15T11:30:00+08:00"}}'

📚 詳細文檔

API 端點

認證相關

• GET /mcp/auth/url：獲取 Google OAuth2 授權鏈接
• POST /mcp/auth/callback：處理 OAuth2 回調
• POST /auth/direct：直接認證

日曆操作

• GET /mcp/calendars：獲取所有可用日曆列表
• GET /mcp/events：從指定日曆獲取事件
• GET /mcp/events/upcoming：獲取所有日曆中的即將進行的事件
• POST /mcp/events/create：創建新事件
• PUT /mcp/events/update：更新現有事件
• DELETE /mcp/events/delete：刪除事件
• GET /mcp/events/detail：獲取特定事件詳情

服務器信息

• GET /mcp/info：獲取服務器信息和可用端點
• GET /health：健康檢查端點

測試方法

運行測試：

npm test
# 或者 yarn test

Docker 部署

構建鏡像

docker build -t google-calendar-mcp .

運行容器

docker run -p 3000:3000 --env-file .env google-calendar-mcp

安全考慮

• 確保 .env 文件不被提交到版本控制系統
• 使用 HTTPS 在生產環境中部署
• 定期更新 Google API 密鑰和憑證

故障排除

常見問題：

1. 認證失敗：檢查 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET 是否正確。
2. 無法連接日曆：確保 OAuth2 過程完成並獲得有效的訪問令牌。

貢獻指南

如何貢獻代碼：

1. Fork 倉庫
2. 創建功能分支
3. 提交更改
4. Pull Request

文檔歷史

• 1.0.0 發佈於 2024年1月15日