Meeting BaaS MCP Server

会议BaaS MCP服务器

一种模型上下文协议（MCP）服务器，提供用于管理会议数据的工具，包括成绩单、录音、日历事件和搜索功能。

快速启动：Claude桌面集成

要将Meeting BaaS与Claude Desktop一起使用，请执行以下操作：

1. 编辑Claude Desktop配置文件：

   vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

1. 添加会议BaaS配置：

   "meetingbaas": {
     "command": "/bin/bash",
     "args": [
       "-c",
       "cd /path/to/meeting-mcp && (npm run build 1>&2) && export MCP_FROM_CLAUDE=true && node dist/index.js"
     ],
     "headers": {
       "x-api-key": "YOUR_API_KEY"
     }
   }

1. 对于日历集成，您可以添加 calendarOAuth 部分到您的 botConfig:

   "botConfig": {
     "calendarOAuth": {
       "platform": "Google",  // or "Microsoft"
       "clientId": "YOUR_OAUTH_CLIENT_ID",
       "clientSecret": "YOUR_OAUTH_CLIENT_SECRET", 
       "refreshToken": "YOUR_REFRESH_TOKEN",
       "rawCalendarId": "primary@gmail.com"  // Optional
     }
   }

1. 保存文件并重新启动Claude Desktop。

注： 日历集成是可选的。只需省略日历，即可在不连接日历的情况下使用会议BaaS calendarOAuth 部分。

概述

该项目实现了一个模型上下文协议（MCP）服务器，允许Claude和Cursor等AI助手访问和操纵会议数据。它公开了一组工具和资源，可用于：

• 邀请会议机器人：创建并邀请机器人参加您的视频会议，自动记录和转录会议

  "Create a new meeting bot for my Zoom call tomorrow"

• 查询会议数据：在会议记录中搜索并查找具体信息，而无需观看整个录音

  "Search my recent meetings for discussions about the quarterly budget"
  "Find all mentions of Project Apollo in yesterday's team meeting"
  "Show me parts of the meeting where Jane was speaking"

• 管理日历事件：查看和组织日历条目和即将举行的会议

• 访问录制信息：获取有关会议记录及其状态的元数据

先决条件

• Node.js（v16或更高版本）
• npm
• 会见BaaS账户：您需要使用公司电子邮件地址访问MeetingBaaS帐户

- 所有日志、机器人和共享链接都可供具有相同公司域的同事使用（而不是像gmail.com这样的个人电子邮件） - 这实现了无缝协作，所有团队成员都可以访问组织中任何人创建的会议记录和成绩单

安装

1. 克隆存储库：

   git clone 
   cd mcp-baas

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

启动服务器：

npm run start

默认情况下，服务器在端口7017上运行，并在以下位置公开MCP端点 http://localhost:7017/mcp.

可用工具

服务器通过MCP协议公开了几个工具：

日历工具

• oauthGuidance：获取有关为Google或Microsoft日历设置OAuth的详细分步说明

- 无需参数 - 返回获取OAuth凭据和设置日历集成的全面说明

• listRawCalendars：列出集成前来自Google或Microsoft的可用日历

- 参数： platform （“谷歌”或“微软”）， clientId, clientSecret, refreshToken - 返回可用日历及其ID和主要状态的列表

• setupCalendarOAuth：使用OAuth凭据集成日历

- 参数： platform （“谷歌”或“微软”）， clientId, clientSecret, refreshToken, rawCalendarId （可选） - 返回与日历详细信息成功集成的确认

• listCalendars：列出所有集成日历

- 无需参数 - 返回所有日历及其名称、电子邮件地址和UUID的列表

• getCalendar：获取有关特定日历集成的详细信息

- 参数： calendarId （日历的UUID） - 返回全面的日历详细信息

• deleteCalendar：永久删除日历集成

- 参数： calendarId （日历的UUID） - 返回删除成功的确认

• resyncAllCalendars：强制刷新所有连接的日历

- 无需参数 - 返回同步操作的状态

• listUpcomingMeetings：从日历中列出即将举行的会议

- 参数： calendarId, status （可选：“即将到来”、“过去”、“全部”）， limit （可选） - 返回包含会议名称、时间和录制状态的会议列表

• listEvents：列出具有全面筛选选项的日历事件

- 参数： calendarId，加上可选的过滤器，如 startDateGte, startDateLte, attendeeEmail等等。 - 返回包含丰富信息的详细事件列表

• listEventsWithCredentials：使用查询中直接提供的凭据列出日历事件

- 参数： calendarId, apiKey，加上与相同的可选过滤器 listEvents - 返回与相同的详细信息 listEvents 但通过直接身份验证

• getEvent：获取特定日历事件的详细信息

- 参数： eventId （事件的UUID） - 返回全面的活动详细信息，包括与会者和录制状态

• scheduleRecording：安排一个机器人来记录即将到来的会议

- 参数： eventId, botName，加上可选设置，如 botImage, recordingMode等等。 - 返回成功调度的确认

• scheduleRecordingWithCredentials：使用查询中直接提供的凭据进行记录的计划

- 参数： eventId, apiKey, botName，加上与相同的可选设置 scheduleRecording - 返回成功调度的确认

• cancelRecording：取消以前安排的录制

- 参数： eventId, allOccurrences （可选，用于重复事件） - 返回取消成功的确认

• cancelRecordingWithCredentials：使用查询中直接提供的凭据取消录制

- 参数： eventId, apiKey, allOccurrences （可选） - 返回取消成功的确认

• checkCalendarIntegration：检查和诊断日历集成状态

- 无需参数 - 返回全面的状态报告和故障排除提示

会议工具

• createBot：创建一个可以加入视频会议以录制和转录会议的会议机器人

- 参数： - meeting_url （要加入的会议的URL） - name （可选机器人名称） - botImage （机器人化身图像的可选URL） - entryMessage （机器人加入时将发送的可选消息） - deduplicationKey （可选键可覆盖加入同一会议的5分钟限制） - nooneJoinedTimeout （如果没有人加入，机器人离开的可选超时时间（秒）） - waitingRoomTimeout （如果被困在候诊室，机器人离开的可选超时时间（秒）） - speechToTextProvider （可选转录提供者：“Gladia”、“Runpod”或“Default”） - speechToTextApiKey （语音转文本提供程序的可选API密钥） - streamingInputUrl （可选的WebSocket URL用于流式传输音频输入） - streamingOutputUrl （可选WebSocket URL，用于流式传输音频输出） - streamingAudioFrequency （流媒体的可选频率：“16khz”或“24khz”） - extra （可选对象，包含有关会议的其他元数据，如会议类型、自定义摘要提示、搜索关键字） - 返回：机器人详细信息，包括ID和加入状态

• getBots：列出所有机器人及其相关会议
• getBotsByMeeting：获取特定会议URL的机器人程序
• getRecording：检索特定机器人/会议的录制信息
• getRecordingStatus：检查正在进行的录制的状态
• getMeetingData：获取特定会议的记录和录制数据

- 参数： meetingId （要获取数据的会议ID） - 返回：有关会议记录的信息，包括持续时间和记录片段计数

• getMeetingDataWithCredentials：使用直接API凭据获取转录和录制数据

- 参数： meetingId （会议ID）， apiKey （用于身份验证的API密钥） - 返回：与相同的信息 getMeetingData 但通过直接身份验证

成绩单工具

• getMeetingTranscript：获取包含演讲者姓名和按演讲者分组的内容的会议记录

- 参数： botId （记录会议的机器人） - 返回：包含说话者信息的完整成绩单，格式为按说话者分组的段落 - 输出示例：

    Meeting: "Weekly Team Meeting"
    Duration: 45m 30s
    Transcript:

    John Smith: Hello everyone, thanks for joining today's call. We have a lot to cover regarding the Q3 roadmap and our current progress on the platform redesign.

    Sarah Johnson: Thanks John. I've prepared some slides about the user testing results we got back yesterday. The feedback was generally positive but there are a few areas we need to address.

• findKeyMoments：自动识别并共享会议中重要时刻的链接

- 参数： botId，可选 meetingTitle，可选列表 topics 查找，可选 maxMoments - 返回：Markdown格式的关键时刻列表，带有链接，根据成绩单自动检测 - 使用人工智能分析来查找重要时刻，而不需要手动选择时间戳

二维码工具

• generateQRCode：创建AI生成的二维码图像，可用作机器人化身

- 参数： - type：二维码类型（网址、电子邮件、电话、短信、文本） - to：二维码的目的地（URL、电子邮件、电话号码或文本） - prompt：AI提示自定义二维码（最多1000个字符）。您可以输入“API密钥：qrc_your_key”或类似短语，将API密钥直接包含在提示文本中。 - style：二维码的样式（Style_default、Style.dots、styleround、stylecrystal） - useAsBotImage：是否将生成的二维码用作机器人头像（默认值：true） - template：二维码的模板ID（可选） - apiKey：您的二维码AI API密钥（可选，如果未提供，将使用默认值） - 返回：生成的二维码图像的URL，可以直接与joinMeeting工具一起使用 - 示例用法：

    "Generate a QR code with my email lazare@spoke.app that looks like a Tiger in crystal style"

- 提示中有API键的示例：

    "Generate a QR code for my website https://example.com that looks like a mountain landscape. Use API key: qrc_my-personal-api-key-123456"

- 带有形式参数的示例：

    "Generate a QR code with the following parameters:
    - Type: email
    - To: john.doe@example.com
    - Prompt: Create a QR code that looks like a mountain landscape
    - Style: style_rounded
    - API Key: qrc_my-personal-api-key-123456"

链接共享工具

• shareableMeetingLink：生成一个格式良好、可共享的会议记录链接

- 参数： botId，加上可选 timestamp, title, speakerName，以及 description - 返回：带有元数据的Markdown格式链接，可以直接在聊天中共享 - 例子：

    📽️ **Meeting Recording: Weekly Team Sync**
    ⏱️ Timestamp: 00:12:35
    🎤 Speaker: Sarah Johnson
    📝 Discussing the new product roadmap

    🔗 [View Recording](https://meetingbaas.com/viewer/abc123?t=755)

• shareMeetingSegments：创建指向会议中多个重要时刻的链接列表

- 参数： botId 以及一系列 segments 带有时间戳、发言人和描述 - 返回：Markdown格式的片段列表，每个片段都有直接链接 - 可用于为长时间会议创建目录

示例工作流

录制会议

1. 为即将召开的会议创建机器人：

   "Create a bot for my Zoom meeting at https://zoom.us/j/123456789"

1. 机器人自动加入会议并开始录制。

1. 检查录制状态：

   "What's the status of my meeting recording for the Zoom call I started earlier?"

日历集成和自动记录

1. 获取获取OAuth凭据的指导：

   "I want to integrate my Google Calendar. How do I get OAuth credentials?"

1. 在集成之前列出可用的日历：

   "List my available Google calendars. Here are my OAuth credentials:
   - Client ID: my-client-id-123456789.apps.googleusercontent.com
   - Client Secret: my-client-secret-ABCDEF123456
   - Refresh Token: my-refresh-token-ABCDEF123456789"

1. 设置与特定日历的日历集成：

   "Integrate my Google Calendar using these credentials:
   - Platform: Google
   - Client ID: my-client-id-123456789.apps.googleusercontent.com
   - Client Secret: my-client-secret-ABCDEF123456
   - Refresh Token: my-refresh-token-ABCDEF123456789
   - Raw Calendar ID: primary@gmail.com"

1. 查看您即将举行的会议：

   "Show me my upcoming meetings from calendar 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

1. 为即将召开的会议安排录制：

   "Schedule a recording for my team meeting with event ID 7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d.
   Configure the bot with:
   - Name: Team Meeting Bot
   - Recording Mode: gallery_view
   - Entry Message: Hello everyone, I'm here to record the meeting"

1. 检查日历中安排的所有录制：

   "Show me all meetings in my calendar that have recordings scheduled"

1. 取消以前安排的录制：

   "Cancel the recording for event 7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d"

1. 如果缺少会议，请刷新日历数据：

   "Force a resync of all my connected calendars"

分析会议内容

1. 获取会议的完整记录：

   "Get the transcript from my team meeting with bot ID abc-123"

1. 查找会议中的关键时刻：

   "Identify key moments from yesterday's product planning meeting with bot ID xyz-456"

1. 分享会议中的特定时刻：

   "Create a shareable link to the part of meeting abc-123 at timestamp 12:45 where John was talking about the budget"

使用直接凭证工具

您可以在查询中直接提供API凭据：

1. 列出具有直接凭据的事件：

   "List events from calendar 5c99f8a4-f498-40d0-88f0-29f698c53c51 using API key tesban where attendee is philipe@spoke.app"

1. 使用直接凭证安排录制：

   "Schedule a recording for event 78d06b42-794f-4efe-8195-62db1f0052d5 using API key tesban with bot name 'Weekly Meeting Bot'"

1. 使用直接凭据取消录制：

   "Cancel the recording for event 97cd62f0-ea9b-42b3-add5-7a607ce6d80f using API key tesban"

1. 使用直接凭据获取会议数据：

   "Get meeting data for meeting 47de9462-bea7-406c-b79a-fd6b82c3de76 using API key tesban"

使用人工智能生成的二维码作为机器人化身

1. 使用您的联系信息和自定义设计生成二维码：

   "Generate a QR code with the following parameters:
   - Type: email
   - To: john.doe@company.com
   - Prompt: Create a professional-looking QR code with abstract blue patterns that resemble a corporate logo
   - Style: style_crystal"

1. 在会议中使用生成的二维码作为机器人化身：

   "Join my Zoom meeting at https://zoom.us/j/123456789 with the following parameters:
   - Bot name: QR Code Assistant
   - Bot image: [URL from the generated QR code]
   - Entry message: Hello everyone, I'm here to record the meeting. You can scan my avatar to get my contact information."

1. 生成一个带有会议链接的二维码，便于分享：

   "Generate a QR code with the following parameters:
   - Type: url
   - To: https://zoom.us/j/123456789
   - Prompt: Create a colorful QR code with a calendar icon in the center
   - Style: style_rounded"

访问会议记录

可以使用机器人ID通过Meeting BaaS查看器直接访问会议记录：

https://meetingbaas.com/viewer/{BOT_ID}

例如：

https://meetingbaas.com/viewer/67738f48-2360-4f9e-a999-275a74208ff5

此查看器提供：

• 会议录像
• 与说话者身份同步的成绩单
• 按演讲者或主题导航
• 与队友直接分享链接

使用时 createBot, getBots，或搜索工具，您将收到机器人ID，可用于构建这些查看器URL，以便轻松访问录制内容。

重要：所有会议记录和链接都会自动与具有相同公司电子邮件域（例如@yourcompany.com）的同事共享。这允许您的整个团队访问录制内容，而不需要个人权限，从而创建一个协作环境，让组织中的每个人都可以访问会议知识。

配置

服务器可以通过环境变量或编辑 src/config.ts 文件。

关键配置选项：

• PORT：服务器侦听的端口（默认值：7017）
• API_BASE_URL：会议BaaS API的基本URL
• DEFAULT_API_KEY：用于测试的默认API密钥

与Cursor集成

要与Cursor集成，请执行以下操作：

1. 打开的游标
2. 转到“设置”
3. 导航到“模型上下文协议”
4. 使用以下命令添加新服务器：

- 名称：“会议BaaS MCP” - 类型：“sse” - 服务器URL:“http://localhost:7017/mcp" - 如果需要身份验证，可以选择添加标头

发展

构建

npm run build

使用MCP检查员进行测试

npm run inspect

开发模式（带自动重新加载）

npm run dev

日志管理

该服务器包括优化的日志记录功能，包括：

npm run cleanup

此命令：

• 清理不必要的日志文件和缓存数据
• 从日志中过滤出重复的ping消息
• 减少磁盘使用量，同时保留重要日志信息
• 为长时间运行的服务器保持较小的日志占用空间

项目结构

• src/index.ts：主要入口点
• src/tools/：工具实施
• src/resources/：资源定义
• src/api/：会议BaaS后端的API客户端
• src/types/：TypeScript类型定义
• src/config.ts：服务器配置
• src/utils/：实用功能

- logging.ts：日志过滤和管理 - tinyDb.ts：持久机器人跟踪数据库

认证

服务器需要在 x-api-key 用于身份验证的标头。您可以在配置中配置默认的API密钥。

许多工具（以“WithCredentials”命名）也支持直接身份验证，在这些工具中，您可以直接将API密钥作为参数而不是在头中提供。

许可证

麻省理工学院

二维码API密钥配置

二维码生成器工具需要来自二维码AI API的API密钥。有几种方法可以提供此功能：

1. 直接在提示中：使用时，将API键直接包含在提示文本中 generateQRCode 工具，例如，“为我的网站生成二维码https://example.com使用API密钥：qrc_your_key“

1. 作为参数：提供您的API密钥作为 apiKey 使用时的参数 generateQRCode 工具

1. 环境变量：设置 QRCODE_API_KEY 环境变量

1. Claude桌面配置：将API密钥添加到位于以下位置的Claude Desktop配置文件中：

- Mac/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

配置示例：

   {
     "headers": {
       "x-api-key": "qrc_your_key_here" 
     }
   }

该工具将按照上面列出的顺序检查API密钥。如果未提供API密钥，则将使用默认的API密钥（如果可用）。

您可以在以下网址注册以获取API密钥： 二维码AI API.