MeetSync MCP Server

mcp-meetsync

用于 MeetSync 的 MCP 服务——一个专为 AI Agent 打造的日历协商 API。

将 MeetSync 的全部 19 个端点作为 MCP 工具开放，让任何兼容 MCP 的大模型都能自主查找可用时间、提出会议时间并确认预订，无需人工来回沟通。

---

安装

npm install -g mcp-meetsync

也可以通过 npx 直接运行：

npx mcp-meetsync

---

配置

服务会读取两个环境变量：

变量	必需	默认值	说明
MEETSYNC_API_URL	否	http://localhost:3000	MeetSync API 的基本 URL
MEETSYNC_API_KEY	是	—	在 X-API-Key 请求头中发送的 API 密钥

将 .env.example 复制为 .env 并填写相应值，或者直接在 Claude 工具定义中传入这些值。

---

添加到 Claude

将以下代码片段粘贴到 Claude 桌面配置文件中（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "meetsync": {
      "command": "npx",
      "args": ["-y", "mcp-meetsync"],
      "env": {
        "MEETSYNC_API_URL": "https://api.yourmeetsync.com",
        "MEETSYNC_API_KEY": "your-api-key-here"
      }
    }
  }
}

保存后，重启 Claude。19 个 MeetSync 工具将出现在 Claude 的工具列表中。

---

工具

MeetSync 的全部 19 个 operationId 均会作为工具开放。工具名称与 operationId 完全一致。

参与者（7 个工具）

工具	使用场景
listParticipants	浏览或搜索已注册的参与者
createParticipant	注册新人，以便为其安排日程
getParticipant	查询特定参与者的时区和服务提供方详情
updateParticipant	修改参与者的姓名、电子邮件、时区或日历设置
deleteParticipant	永久移除参与者（使用 force 执行级联操作）
getParticipantPreferences	查看参与者的工作时间和日程安排限制
setParticipantPreferences	定义或替换工作时间、不可安排时段和缓冲时间

可用时间（2 个工具）

工具	使用场景
getParticipantAvailability	查找单个参与者的空闲时段
findMutualAvailability	查找所有参与者均可参加的评分时段

提议（5 个工具）

工具	使用场景
listProposals	浏览待处理或历史提议
createProposal	提出候选时段并发送给参与者以达成共识
getProposal	查看提议状态及参与者的回复情况
cancelProposal	撤回待处理的提议
respondToProposal	记录参与者的接受或拒绝

预订（5 个工具）

工具	使用场景
listBookings	查看已确认、已取消或已重新安排的会议
createBooking	根据已接受的提议确认预订，或直接预订
getBooking	获取特定会议的完整详情
rescheduleBooking	将已确认的会议改到新的时间
cancelBooking	永久取消会议

---

Agent 工作流示例

以下是 AI Agent 使用这些工具时会遵循的完整日程安排工作流：

1. createParticipant  ← register [email protected]
2. createParticipant  ← register [email protected]
3. setParticipantPreferences  ← Alice: Mon–Fri 09–17, 15 min buffer
4. setParticipantPreferences  ← Bob: Mon–Fri 10–18, no back-to-back
5. findMutualAvailability  ← find 60-min slots next week for [alice, bob]
   → returns top 5 scored slots
6. createProposal  ← "Budget Review" with top 3 slots, expires in 24h
   → proposal id: prop_abc123
7. respondToProposal  ← alice accepts, prefers slot 1
8. respondToProposal  ← bob accepts, prefers slot 1
   → proposal auto-transitions to "accepted", acceptedSlotId set
9. getProposal  ← confirm acceptedSlotId
10. createBooking  ← proposalId + slotId
    → booking confirmed, calendarEventIds written

---

开发

# Install dependencies
npm install

# Type-check without building
npm run typecheck

# Build to dist/
npm run build

# Run in dev mode (auto-reloads)
MEETSYNC_API_URL=http://localhost:3000 MEETSYNC_API_KEY=dev-key npm run dev

---

架构

src/
  index.ts          ← MCP Server, ListTools + CallTool handlers, stdio transport
  client.ts         ← Typed fetch wrapper: GET/POST/PUT/PATCH/DELETE + X-API-Key injection
  tools/
    participants.ts  ← 7 participant tools + handlers
    availability.ts  ← 2 availability tools + handlers
    proposals.ts     ← 5 proposal tools + handlers
    bookings.ts      ← 5 booking tools + handlers

每个工具文件都会导出：

• 一个包含 name、description 和 inputSchema（严格的 JSON Schema）的 Tool[] 数组
• 一个会通过 client 调用 MeetSync API 的异步函数 handle*Tool(name, args)

---

许可证

MIT