Google Workspace MCP Server By Itc

🚀 谷歌工作區 MCP 服務器

本項目是一個谷歌工作區 MCP 服務器，可實現郵件和日曆的多種操作，如郵件的搜索、發送、標籤修改，以及日曆日程的查看、創建、更新和刪除等功能。

🚀 快速開始

必要條件

1. 安裝 Node.js 和 npm。
2. 配置 Google Workspace 開發者憑據。
3. 確保已啟用 Gmail API 和 Calendar API。

設置步驟

項目初始化

npm init -y

安裝依賴項

npm install express cors @google/googleapis

創建配置文件

創建 config.js：

const config = {
    google: {
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET',
        refreshToken: 'YOUR_REFRESH_TOKEN'
    }
};

module.exports = config;

實現 API 調用

參考代碼示例：

const {google} = require('googleapis');
const config = require('./config');

function gmailApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId, 
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // 實現具體的 API 調用邏輯
}

function calendarApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId,
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // 實現具體的日曆 API 調用邏輯
}

項目構建

npm run build

運行命令

npm start

✨ 主要特性

郵件操作

• 最近郵件列表：獲取最近未讀郵件列表。

{
    "maxResults": 5,
    "query": "is:unread"
}

• 郵件搜索：根據條件搜索郵件。

{
    "query": "from:example@gmail.com has:attachment",
    "maxResults": 10
}

• 發送郵件：發送郵件到指定收件人。

{
    "to": "recipient@example.com",
    "subject": "Hello",
    "body": "Message content",
    "cc": "cc@example.com",
    "bcc": "bcc@example.com"
}

• 修改郵件標籤：為郵件添加或移除標籤。

{
    "id": "message_id",
    "addLabels": ["UNREAD"],
    "removeLabels": ["INBOX"]
}

日曆操作

• 查看日程安排：查看指定時間範圍內的日程。

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

• 創建日程：創建新的日程安排。

{
    "summary": "團隊會議",
    "location": "會議室",
    "description": "每週同步",
    "start": "2024-01-24T10:00:00Z",
    "end": "2024-01-24T11:00:00Z",
    "attendees": ["colleague@example.com"]
}

• 更新日程：更新已有日程的信息。

{
    "eventId": "event_id",
    "summary": "更新後的會議標題",
    "location": "虛擬會議室",
    "start": "2024-01-24T11:00:00Z",
    "end": "2024-01-24T12:00:00Z"
}

• 刪除日程：刪除指定日程。

{
    "eventId": "event_id"
}

📚 詳細文檔

常見問題排查

• 無法啟動服務？：檢查端口是否被佔用或配置文件是否有誤。
• API 請求失敗？：確保憑據有效且網絡連接正常。
• 日誌信息不足？：啟用詳細日誌記錄以獲取更多調試信息。

文檔參考

• Node.js 官方文檔
• 谷歌 APIs 節點庫
• Gmail API 文檔
• Calendar API 文檔