MCP Google Calendar Server

🚀 谷歌日曆模型上下文協議服務器（Google Calendar MCP Server）

這是一個用於與谷歌日曆交互的服務器端項目，支持創建、讀取、更新和刪除日曆事件，還能查找空閒時間段。項目使用 Node.js 編寫，並通過 OAuth 2.0 進行身份驗證。

🚀 快速開始

本項目是用於與谷歌日曆交互的服務器端項目，支持對日曆事件的 CRUD 操作以及查找空閒時間段。使用 Node.js 編寫，通過 OAuth 2.0 進行身份驗證。

✨ 主要特性

• 創建事件：可添加新的日曆事件。
• 讀取事件：能獲取指定時間段內的所有事件。
• 更新事件：可修改現有事件的詳細信息。
• 刪除事件：能移除特定的日曆事件。
• 查找空閒時間：可在指定時間段內查找可用時間窗口。

📦 安裝指南

1. 準備工作

• 下載項目文件並解壓到目標目錄。
• 確保已安裝 Node.js（建議版本 8.0 或更高）和 npm。

2. 安裝依賴項

在項目根目錄中運行以下命令：

npm install

3. 配置環境變量

複製 .env.example 文件為 .env，並根據實際情況填寫以下內容：

CLIENT_ID=你的客戶端ID
CLIENT_SECRET=你的客戶端密碼
REDIRECT_URI=重定向鏈接地址（例如：http://localhost:3000/oauth2callback）
REFRESH_TOKEN=獲取的刷新令牌

💻 使用示例

基礎用法

作為 HTTP/SSE 服務器

• 在項目根目錄中運行以下命令啟動服務：

npm run start:http

• 默認監聽地址為 http://localhost:3334。

作為 CLI 工具

• 運行以下命令以控制檯模式啟動：

npm run start:stdio

高級用法

創建事件

{
  "summary": "會議",
  "description": "重要項目討論會",
  "start": {
    "dateTime": "2023-10-10T09:00:00+08:00"
  },
  "end": {
    "dateTime": "2023-10-10T11:00:00+08:00"
  }
}

📚 詳細文檔

獲取刷新令牌

步驟說明

1. 運行以下腳本以啟動授權流程：

const { google } = require('googleapis');
const http = require('http');
const url = require('url');

// 替換為你的實際信息
const CLIENT_ID = '你的客戶端ID';
const CLIENT_SECRET = '你的客戶端密碼';
const REDIRECT_URI = 'http://localhost:3000/oauth2callback';

const oauth2Client = new google.auth.OAuth2(
  CLIENT_ID,
  CLIENT_SECRET,
  REDIRECT_URI
);

const scopes = [
  'https://www.googleapis.com/auth/calendar',
  'https://www.googleapis.com/auth/calendar.events'
];

function getRefreshToken() {
  const server = http.createServer(async (req, res) => {
    const queryParams = url.parse(req.url, true).query;
    
    if (queryParams.code) {
      try {
        const { tokens } = await oauth2Client.getToken(queryParams.code);
        console.log('刷新令牌:', tokens.refresh_token);
        res.end('身份驗證成功！你可以關閉此窗口。');
        server.close();
      } catch (error) {
        console.error('獲取令牌失敗:', error);
        res.end('身份驗證失敗！');
      }
    }
  }).listen(3000, () => {
    const authUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes,
      prompt: 'consent'
    });

    console.log('在瀏覽器中打開以下鏈接:');
    console.log(authUrl);
  });
}

getRefreshToken();

2. 根據腳本輸出的 URL，在瀏覽器中訪問並按照提示完成授權流程。
3. 授權完成後，控制檯將顯示新的刷新令牌。

開發與調試

npm run dev

常見問題解決

• 認證錯誤：檢查客戶端 ID、密碼和重定向 URI 是否正確配置。
• 服務器啟動失敗：確保端口未被佔用或權限設置正確。

📄 許可證

本項目的使用遵循 ISC 協議。