When2meet MCP

🚀 When2Meet MCP 服務器

一款基於人工智能的安排助手，藉助模型上下文協議（MCP）自動完成 When2Meet 可用性標記。該工具可幫助用戶提取事件詳細信息、選擇時間槽，並在 When2Meet 安排投票中自動標記可用性。

🚀 快速開始

安裝

git clone https://github.com/joyce-yuan/when2meet-mcp.git
cd when2meet-mcp
npm install

運行 MCP 服務器

node when2meet-server.js

測試運行 MCP 客戶端

node client.js

✨ 主要特性

• 🔍 提取事件詳情：自動抓取並解析 When2Meet 事件。
• 🗣️ 智能時間選擇：支持使用自然語言、代碼或直接時間戳來選擇時間槽。
• 🤖 自動化可用性標記：無需手動點擊，即可完成可用性標記。
• 🔌 MCP 集成：可與任何支持模型上下文協議的 AI 助手連接。

💻 使用示例

基礎用法

const { Client } = require("@modelcontextprotocol/sdk/client/index.js");
const { StdioClientTransport } = require("@modelcontextprotocol/sdk/client/stdio.js");

// 創建客戶傳輸
const transport = new StdioClientTransport({
  command: "node",
  args: ["when2meet-server.js"]
});

// 初始化客戶端
const client = new Client(
  { name: "when2meet-client", version: "1.0.0" },
  { capabilities: { prompts: {}, resources: {}, tools: {} } }
);

// 連接並使用工具
await client.connect(transport);

// 獲取事件詳情
const eventDetails = await client.callTool({
  name: "get-event-details",
  arguments: { eventUrl: "https://www.when2meet.com/your-event-id" }
});

// 標記可用性
await client.callTool({
  name: "mark-when2meet-availability", 
  arguments: {
    eventUrl: "https://www.when2meet.com/your-event-id",
    userName: "您的姓名",
    timestamps: [1744549200, 1744550100]
  }
});

📚 詳細文檔

支持工具

1. get-event-details

從任何 When2Meet URL 提取信息。

// 示例響應
{
  "name": "團隊會議",
  "dateRange": "2025年4月7日至9日",
  "availableTimeslots": {
    // 結構化的時間槽數據，包含時間戳
  }
}

2. generate-availability-prompt

創建一個結構化的選擇提示，包含所有可用時間槽。

[d0t0] 9:00 上午 (1744549200)
[d0t1] 9:15 上午 (1744550100)

3. parse-availability-selections

將選擇轉換為實際的時間戳，支持多種輸入格式：

• 時間槽代碼（d0t0 d1t2）
• 時間模式（morning0 day1）
• 直接時間戳（1744549200, 1744550100）

4. mark-when2meet-availability

使用瀏覽器自動化在 When2Meet 上自動標記您的可用性。

使用場景

• AI 助手集成：讓 AI 助手為您處理安排。
• 自動化安排：無需手動干預即可安排會議。
• 自然語言安排：使用 plain English 表達可用性。
• 批量標記可用性：一次標記多個時間槽。

要求

📄 許可證

本項目採用 MIT 許可證。

即將推出的集成

• 支持直接調度 Google 日曆