When2Meet MCP 服务器

一个由 AI 驱动的日程安排助手，通过模型上下文协议 (MCP) 自动标记 When2Meet 的可用性。此工具可帮助用户提取活动详情、选择时间段，并自动在 When2Meet 安排投票中标记可用性。

功能

• 🔍 提取活动详情: 自动抓取和解析 When2Meet 活动
• 🗣️ 智能时间选择: 使用自然语言、代码或直接时间戳选择时间段
• 🤖 自动可用性标记: 无需手动点击即可标记您的可用性
• 🔌 MCP 集成: 与任何支持 模型上下文协议 的 AI 助手连接

快速开始

安装

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

运行 MCP 服务器

node when2meet-server.js

运行 MCP 客户端进行测试

node client.js

支持的工具

1. get-event-details

从任何 When2Meet URL 提取信息。

// 示例响应
{
  "name": "团队会议",
  "dateRange": "2025 年 4 月 7-9 日",
  "availableTimeslots": {
    // 结构化的时间段数据，包含时间戳
  }
}

2. generate-availability-prompt

创建一个包含所有可用时间段的结构化选择提示。

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

3. parse-availability-selections

使用多种输入格式将选择转换为实际时间戳：

• 时隙代码 (d0t0 d1t2)
• 时间模式 (morning0 day1)
• 直接时间戳 (1744549200, 1744550100)

4. mark-when2meet-availability

使用浏览器自动化自动标记您在 When2Meet 上的可用性。

客户端使用示例

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]
  }
});

使用场景

• AI 助手集成: 让 AI 助手为您处理日程安排
• 自动日程安排: 无需手动干预即可安排会议
• 自然语言日程安排: 用简单的英语表达可用性
• 批量可用性标记: 一次标记多个时间段

要求

• Node.js 18+
• @modelcontextprotocol/sdk (^1.8.0)
• puppeteer
• zod

许可证

MIT

即将推出的集成

• 支持 Google 日历直接安排