Microsoft 365 Bookings MCP Server

基本能力

产品定位

m365-bookings-mcp 是一个用于与 Microsoft Bookings 交互的 MCP 服务器，主要用于管理和查询预订业务的相关信息。

核心功能

• 列出所有预订业务
• 获取特定业务的员工成员
• 获取特定业务提供的服务
• 获取特定业务的预约信息

适用场景

• 企业内部的预约管理系统
• 服务行业的日程安排和预约管理
• 需要与 Microsoft Bookings 集成的应用程序

工具列表

• get_bookings_businesses: 获取组织中所有预订业务的列表。
• get_business_staff: 获取特定预订业务的员工成员，需要提供 businessId 参数。
• get_business_services: 获取特定预订业务提供的服务，需要提供 businessId 参数。
• get_business_appointments: 获取特定预订业务的预约信息，需要提供 businessId 参数，可选参数包括 startDate 和 endDate（ISO 格式）。

常见问题解答

• 如何获取 Microsoft Graph API 的权限？需要在 Azure AD 应用注册中添加 BookingsAppointment.ReadWrite.All、BookingsBusiness.ReadWrite.All 和 BookingsStaffMember.ReadWrite.All 权限。
• 如何手动安装？需要创建 Azure AD 应用注册，配置 .env 文件，安装依赖并构建服务器。

使用教程

使用依赖

1. 创建 Azure AD 应用注册：
2. 访问 Azure 门户 > Azure Active Directory > 应用注册
3. 创建新注册

4. 添加 Microsoft Graph API 权限：

   • BookingsAppointment.ReadWrite.All
   • BookingsBusiness.ReadWrite.All
   • BookingsStaffMember.ReadWrite.All

5. 创建 .env 文件，包含以下变量：

MICROSOFT_GRAPH_CLIENT_ID=your-client-id
MICROSOFT_GRAPH_CLIENT_SECRET=your-client-secret
MICROSOFT_GRAPH_TENANT_ID=your-tenant-id

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @DynamicEndpoints/m365-bookings-mcp --client claude

手动安装

1. 安装依赖：

npm install

1. 构建服务器：

npm run build

调试方式

安装完成后，可以通过调用提供的工具来调试服务器，例如：

# 获取所有预订业务
node get_bookings_businesses.js

# 获取特定业务的员工成员
node get_business_staff.js --businessId your-business-id

# 获取特定业务的服务
node get_business_services.js --businessId your-business-id

# 获取特定业务的预约信息
node get_business_appointments.js --businessId your-business-id --startDate 2023-01-01 --endDate 2023-12-31

许可证

None