Meet.bot MCP(模型上下文协议)
用于Meet.bot预订页面API的模型上下文协议(MCP)服务器,使人工智能助手能够与日程安排和预订功能进行交互。
这是什么?
此MCP服务器将AI助手(如Claude、ChatGPT和其他支持MCP的助手)连接到您的Meet.bot帐户,允许他们代表您安排会议。您无需手动复制预订链接或查看日历,只需让您的AI助手“下周与John安排30分钟的会议”,它就会通过您的MeetBot日程页面处理预订。
它是如何工作的:
- 将您的MeetBot API令牌连接到MCP服务器
- 配置您的AI助手以使用此MCP服务器
- 让你的人工智能助手安排会议-它可以直接通过你的MeetBot帐户检查你的可用性、查找时间段和预订会议
这对于那些想要自动化会议日程安排并让他们的人工智能助手智能管理日历的繁忙专业人士来说尤其有用。
如果你没有帐户,你可以在以下网址免费获得一个https://meet.bot
特性
- API全面覆盖:从Meet.bot预订页面API v1实现所有端点
- 类型安全:完全支持TypeScript,具有全面的类型定义
- 运行时验证:用于输入验证和数据完整性的Zod模式
- 身份验证支持:承载令牌身份验证
- 错误处理:具有详细错误消息的稳健错误处理
- 健康检查:使用/v1/pages端点进行内置运行状况监视
- MCP协议合规性:完整的模型上下文协议服务器实现
- 双模式支持:本地运行(stdio)或远程运行(HTTP/SSE)
- 生产部署:住在https://mcp.meet.bot
- 生产就绪:经过彻底测试和验证,可用于生产
安装
npm install @meetbot/mcp快速开始
1.安装和配置
# Install the package
npm install @meetbot/mcp
# Or install globally for CLI usage
npm install -g @meetbot/mcp2.身份验证
身份验证是 不 一个工具——它是基于连接的:
- HTTP/SSE(远程,例如。https://mcp.meet.bot):发送
Authorization: Bearer连接时在请求标头中。服务器将此令牌用于该会话中的所有API调用。 - Stdio(本地):设置
MEETBOT_AUTH_TOKEN启动服务器时的环境变量(例如。MEETBOT_AUTH_TOKEN=your_token npx @meetbot/mcp).
没有 configure_meetbot 或类似工具;AI使用下面的工具,身份验证由连接处理。
3.使用可用工具
MCP服务器提供以下工具:
获取日程安排页面
await get_scheduling_pages();
// Returns all scheduling pages for the authenticated user获取页面信息
await get_page_info({
page: "https://meet.bot/user/30min"
});
// Returns detailed information about a specific scheduling page获取可用插槽
await get_available_slots({
page: "https://meet.bot/user/30min",
count: 10,
start: "2025-01-01",
end: "2025-01-31",
timezone: "America/New_York",
booking_link: true
});
// Returns available booking slots with optional filters预订会议
await book_meeting({
page: "https://meet.bot/user/30min",
guest_email: "guest@example.com",
guest_name: "Jane Doe",
notes: "Meeting to discuss project requirements",
start: "2025-01-15T14:00:00Z"
});
// Books a new meeting slot健康检查
await health_check();
// Verifies API connectivity using the /v1/pages endpoint部署选项
MCP服务器可以在两种模式下运行:
1.本地模式(标准运输)
用于与Claude Desktop等人工智能助手进行本地集成。使用stdio传输进行通信。
# Run locally
npx @meetbot/mcp
# Or with environment variable
MEETBOT_AUTH_TOKEN="your_token" npx @meetbot/mcp2.HTTP模式(SSE传输)
用于使用HTTP/SSE传输的远程部署。这允许通过网络访问MCP服务器。
运行HTTP服务器
# Build and start the HTTP server
npm run build
npm run start:http
# Or with custom port
PORT=8080 npm run start:http
# Or run directly with npx
npx meetbot-mcp-http服务器端点
- SSE端点:
GET /sse-为MCP通信建立SSE连接 - 消息端点:
POST /messages?sessionId=-接收客户端消息 - 健康检查:
GET /health-服务器运行状况
认证
所有请求都需要在Authorization标头中包含Bearer令牌:
Authorization: Bearer 相同的令牌用于使用Meet.bot API进行身份验证。
测试HTTP服务器
本地测试:
# Health check (should fail without auth)
curl http://localhost:3000/health
# Health check with authentication
curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/health
# Connect to SSE endpoint
curl -N -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3000/sse
# Or use the test script
./test-http-server.sh YOUR_TOKEN生产测试:
# Test the live deployment
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://mcp.meet.bot/health
# Expected response:
# {"status":"ok","service":"meetbot-mcp"}部署
HTTP服务器可以部署到各种平台:
- 铁路:
railway up✅ 住在https://mcp.meet.bot - Fly.io:
fly launch && fly deploy - 谷歌云运行:基于容器的部署
- AWS应用程序运行程序:基于容器的部署
- 任何VPS:直接使用Node.js运行
示例:连接到生产
# Your MCP client should connect to:
# https://mcp.meet.bot/sse
# With Authorization header:
# Authorization: Bearer Dockerfile示例:
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist ./dist
EXPOSE 3000
CMD ["node", "dist/cli-http.js"]MCP集成
使用AI助手
此MCP服务器可以与Claude、ChatGPT等支持模型上下文协议的AI助手集成。
配置示例
{
"mcpServers": {
"meetbot": {
"command": "npx",
"args": ["@meetbot/mcp"],
"env": {
"MEETBOT_AUTH_TOKEN": "your_bearer_token_here"
}
}
}
}可用的MCP工具
服务器为AI助手提供了5个工具:
get_scheduling_pages-列出所有日程安排页面get_page_info-获取页面详细信息get_available_slots-查找可用的时间段book_meeting-预订会议health_check-使用/v1/pages端点验证API连接
身份验证由连接提供(远程HTTP标头中的承载令牌,或 MEETBOT_AUTH_TOKEN 对于本地stdio)——没有单独的配置工具。
测试和验证
该包装已经过彻底的测试和验证:
✅ MCP协议合规性:完全支持JSON-RPC 2.0 ✅ 工具发现:所有5个工具均正确暴露 ✅ 错误处理:优雅的错误响应 ✅ 类型安全:完全支持TypeScript ✅ 模式验证:使用Zod进行输入验证 ✅ 生产就绪:使用真实的MCP客户端进行测试
包统计
- 包装尺寸:12.8 kB(58.0 kB未包装)
- 测试覆盖率:21次通过测试
- 依赖项:3个生产依赖关系
- TypeScript:100%类型覆盖率
- 生成状态: ✅ 经过
- npm注册表:已发布并可用
用法示例
作为图书馆
import { MeetbotClient, MeetbotMCPServer } from '@meetbot/mcp';
// Use as a direct API client
const client = new MeetbotClient({
authToken: 'your_token'
});
// Use as an MCP server
const server = new MeetbotMCPServer();
await server.run();作为MCP服务器
# Run the MCP server
npx @meetbot/mcp
# Or install globally
npm install -g @meetbot/mcp
meetbot-mcpAPI 参考
MeetbotClient
用于直接集成的核心API客户端:
import { MeetbotClient } from '@meetbot/mcp';
const client = new MeetbotClient({
authToken: 'your_token'
});
// Get all scheduling pages
const pages = await client.getPages();
// Get page information
const pageInfo = await client.getPageInfo({
page: 'https://meet.bot/user/30min'
});
// Get available slots
const slots = await client.getSlots({
page: 'https://meet.bot/user/30min',
count: 20
});
// Book a meeting
const booking = await client.bookSlot({
page: 'https://meet.bot/user/30min',
guest_email: 'guest@example.com',
guest_name: 'Jane Doe',
start: '2025-01-15T14:00:00Z'
});数据类型
所有API响应都是完全键入的:
interface BookSlot {
success: boolean;
page: string;
guest_email: string;
guest_name: string;
notes?: string;
start: string;
ical_uid: string;
}
interface PageInfo {
title: string;
duration: number;
url: string;
owner_name: string;
max_days_into_the_future: number;
}
interface Slots {
count: number;
duration: number;
slots: SlotDetails[];
}配置
环境变量
您可以使用环境变量配置MCP服务器:
export MEETBOT_AUTH_TOKEN="your_bearer_token"
# Then run the server
meetbot-mcp认证
Auth是基于连接的,而不是工具:
- HTTP/SSE:发送
Authorization: Bearer当连接到MCP服务器时,在请求标头中。 - 工作室:设置
MEETBOT_AUTH_TOKEN运行服务器时(例如。MEETBOT_AUTH_TOKEN=your_token meetbot-mcp).
发展
运行测试
npm test
npm run test:watch掉毛
npm run lint
npm run lint:fixCLI使用情况
该软件包包括一个用于运行MCP服务器的命令行界面:
# Install globally
npm install -g @meetbot/mcp
# Run the MCP server
meetbot-mcp
# Or run directly with npx (no installation required)
npx @meetbot/mcp环境变量
您可以使用环境变量配置服务器:
export MEETBOT_AUTH_TOKEN="your_bearer_token"
# Then run the server
meetbot-mcp错误处理
MCP服务器为常见问题提供详细的错误消息:
- 配置错误:配置参数缺失或无效
- 身份验证错误:无效令牌
- API错误:来自Meet.bot API的详细错误消息
- 验证错误:输入验证失败,出现特定字段错误
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 添加新功能的测试
- 提交合并请求
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
支持
- 文档: https://docs.meet.bot
- 问题: GitLab问题
- 讨论: GitLab讨论
更新日志
1.2.9
- 服务器卡:已添加
/.well-known/mcp/server-card.json用于发现和手动元数据(工具、提示、身份验证) - 史密斯品质:工具注释(
audience,priority),更丰富的参数描述,并提示质量评分能力 - 提示(技能):Smithery和客户的六个MCP提示:
schedule_meeting,check_availability,book_for_guest,share_booking_link,list_my_pages,suggest_times充满prompts/list和prompts/get支持
1.2.7
- 配置更新示例:已删除过时
MEETBOT_BASE_URL从示例配置(基本URL被硬编码为https://meet.bot)
1.2.6
- 文档更新:更新了从铁路到https://mcp.meet.bot
- 增强的自述文件:添加了“这是什么?”部分,解释了MCP的目的以及如何使用它通过MeetBot帐户安排会议
- 用户引导:添加了注册免费Meet.bot帐户的链接
1.2.5
- Jest配置:更新了ES模块支持的Jest配置
- 构建改进:从TypeScript编译中排除测试文件
- 出版:完善出版清单和文件
1.1.1
- ES模块修复:修复了Railway和其他Node.js部署的ES模块兼容性
- 导入扩展:适当添加
.js所有相关进口的扩展 - 实时部署:已成功部署到https://mcp.meet.bot
- 生产验证:确认在生产环境中工作
1.1.0
- HTTP/SSE传输:添加了具有SSE传输的HTTP服务器,用于远程部署
- 承载令牌身份验证:实现了HTTP端点的身份验证
- 多模式支持:可以作为本地stdio服务器或远程HTTP服务器运行
- 部署就绪:为Railway、Fly.io等添加了Dockerfile和部署配置。
- 健康检查端点:已添加
/health监控端点 - 会话管理:正确处理运输清理会话
- 生产就绪:完成HTTP实现,包括身份验证和错误处理
1.0.4
- 固定健康检查:现在使用真实
/v1/pages端点而不是虚假的健康端点 - 更新文档:澄清健康检查实施细节
- 提高了可靠性:运行状况检查现在正确验证API连接
1.0.3
- 简化配置:删除了baseUrl要求-现在硬编码为https://meet.bot
- 更新文档:简化配置示例
- 改进用户体验:用户只需提供authToken
1.0.2
- 固定身份验证:删除了不支持的sessionId参数
- 已更正API URL:已从api.meet.bot更新为meet.bot
- 更新文档:准确的身份验证示例
1.0.1
- 增强文档:包含使用示例的全面自述文件
- MCP集成指南:添加了AI助手配置示例
- 测试结果:添加了验证和测试信息
1.0.0
- 初始版本 -用于Meet.bot API的生产就绪MCP服务器
- 全面覆盖API -所有Meet.bot预订页面API v1端点
- TypeScript支持 -具有全面定义的全类型安全
- 运行时验证 -用于输入验证和数据完整性的Zod模式
- MCP服务器实现 -完全符合模型上下文协议
- CLI工具 -用于运行MCP服务器的命令行界面
- 错误处理 -具有详细消息的稳健错误处理
- 认证 -支持承载令牌身份验证
- 健康检查 -使用/v1/pages端点内置API连接监控
- 测试 -综合测试套件,21项测试通过
- 文档 -完整的API文档和使用示例
- 功能测试 -通过真实的MCP客户端请求进行验证
- npm发布 -已成功发布到npm注册表
