MCP 服务器

Meeting BaaS MCP Server

一个模型上下文协议服务器，使 AI 助手能够管理会议数据，包括创建会议机器人、搜索文字记录和组织日历事件。

README

Meeting BaaS MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供用于管理会议数据的工具，包括文字记录、录音、日历事件和搜索功能。

概述

本项目实现了一个模型上下文协议 (MCP) 服务器，允许像 Claude 和 Cursor 这样的 AI 助手访问和操作会议数据。它公开了一组工具和资源，可用于：

邀请会议机器人：创建并邀请机器人加入您的视频会议，自动录制和转录会议
```
"为我明天的 Zoom 会议创建一个新的会议机器人"
```

查询会议数据：搜索会议记录，找到特定信息，而无需观看整个录音

"搜索我最近的会议，查找关于季度预算的讨论"
"查找昨天团队会议中所有提及阿波罗项目的地方"
"向我展示简在会议中发言的部分"

管理日历事件：查看和组织日历条目和即将举行的会议
访问录音信息：获取关于会议录音及其状态的元数据

前提条件

Node.js (v16 或更高版本)
npm
MeetingBaaS 账户：您需要使用您的公司电子邮件地址访问 MeetingBaaS 账户
- 所有日志、机器人和共享链接都可供具有相同公司域名的同事使用（不是像 gmail.com 这样的个人电子邮件）
- 这实现了无缝协作，所有团队成员都可以访问组织中任何人创建的会议录音和文字记录

安装

克隆存储库：
```
git clone <repository-url>
cd mcp-baas
```
安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```

用法

启动服务器：

npm run start

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

可用工具

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

日历工具

oauthGuidance：获取关于设置 Google 或 Microsoft 日历的 OAuth 的详细分步说明
- 无需参数
- 返回关于获取 OAuth 凭据和设置日历集成的全面说明
listRawCalendars：在集成之前列出 Google 或 Microsoft 中可用的日历
- 参数：platform ("Google" 或 "Microsoft")，clientId，clientSecret，refreshToken
- 返回可用日历的列表，其中包含它们的 ID 和主要状态
setupCalendarOAuth：使用 OAuth 凭据集成日历
- 参数：platform ("Google" 或 "Microsoft")，clientId，clientSecret，refreshToken，rawCalendarId (可选)
- 返回成功集成日历的确认信息，其中包含日历详细信息
listCalendars：列出所有已集成的日历
- 无需参数
- 返回所有日历的列表，其中包含它们的名称、电子邮件地址和 UUID
getCalendar：获取关于特定日历集成的详细信息
- 参数：calendarId (日历的 UUID)
- 返回全面的日历详细信息
deleteCalendar：永久删除日历集成
- 参数：calendarId (日历的 UUID)
- 返回成功删除的确认信息
resyncAllCalendars：强制刷新所有连接的日历
- 无需参数
- 返回同步操作的状态
listUpcomingMeetings：列出日历中即将举行的会议
- 参数：calendarId，status (可选: "upcoming", "past", "all")，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 (录制会议的机器人)
返回：完整的文字记录，其中包含发言人信息，格式化为按发言人分组的段落

示例输出：

会议: "每周团队会议"
时长: 45m 30s
文字记录:

John Smith: 大家好，感谢大家参加今天的会议。我们有很多关于 Q3 路线图和我们当前平台重新设计的进展需要讨论。

Sarah Johnson: 谢谢 John。我准备了一些关于昨天收到的用户测试结果的幻灯片。反馈总体上是积极的，但我们需要解决一些领域。

findKeyMoments：自动识别并共享指向会议中重要时刻的链接
- 参数：botId，可选的 meetingTitle，要查找的可选 topics 列表，以及可选的 maxMoments
- 返回：Markdown 格式的关键时刻列表，其中包含链接，根据文字记录自动检测
- 使用 AI 驱动的分析来查找重要时刻，而无需手动选择时间戳

二维码工具

generateQRCode：创建一个 AI 生成的二维码图像，可以用作机器人头像
- 参数：
  - type：二维码类型 (url, email, phone, sms, text)
  - to：二维码的目标 (URL, 电子邮件, 电话号码, 或文本)
  - prompt：用于自定义二维码的 AI 提示 (最多 1000 个字符)。您可以通过键入 "API key: qrc_your_key" 或类似短语，直接在提示文本中包含您的 API 密钥。
  - style：二维码的样式 (style_default, style_dots, style_rounded, style_crystal)
  - useAsBotImage：是否将生成的二维码用作机器人头像 (默认: true)
  - template：二维码的模板 ID (可选)
  - apiKey：您的 QR Code AI API 密钥 (可选，如果未提供，将使用默认密钥)
- 返回：指向生成的二维码图像的 URL，可以直接与 joinMeeting 工具一起使用
- 用法示例：
```
"生成一个包含我的电子邮件 lazare@spoke.app 的二维码，看起来像水晶风格的老虎"
```
- 提示中包含 API 密钥的示例：
```
"为我的网站 https://example.com 生成一个二维码，看起来像山地景观。使用 API 密钥：qrc_my-personal-api-key-123456"
```
- 使用正式参数的示例：
```
"生成一个具有以下参数的二维码：
- 类型：email
- 目标：john.doe@example.com
- 提示：创建一个看起来像山地景观的二维码
- 样式：style_rounded
- API 密钥：qrc_my-personal-api-key-123456"
```

链接共享工具

shareableMeetingLink：生成一个格式良好的、可共享的会议录音链接
- 参数：botId，加上可选的 timestamp，title，speakerName 和 description
- 返回：Markdown 格式的链接，其中包含可以直接在聊天中共享的元数据
- 示例：
```
📽️ **会议录音：每周团队同步**
⏱️ 时间戳：00:12:35
🎤 发言人：Sarah Johnson
📝 讨论新的产品路线图

🔗 [查看录音](https://meetingbaas.com/viewer/abc123?t=755)
```
shareMeetingSegments：创建指向会议中多个重要时刻的链接列表
- 参数：botId 和一个 segments 数组，其中包含时间戳、发言人和描述
- 返回：Markdown 格式的段列表，其中包含指向每个时刻的直接链接
- 用于为长时间的会议创建目录

示例工作流程

录制会议

为您即将举行的会议创建一个机器人：

"为我在 https://zoom.us/j/123456789 举行的 Zoom 会议创建一个机器人"

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

检查录制状态：

"我之前开始的 Zoom 会议的录制状态是什么？"

日历集成和自动录制

获取关于获取 OAuth 凭据的指导：

"我想集成我的 Google 日历。如何获取 OAuth 凭据？"

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

"列出我可用的 Google 日历。这是我的 OAuth 凭据：
- 客户端 ID：my-client-id-123456789.apps.googleusercontent.com
- 客户端密钥：my-client-secret-ABCDEF123456
- 刷新令牌：my-refresh-token-ABCDEF123456789"

使用特定日历设置日历集成：

"使用这些凭据集成我的 Google 日历：
- 平台：Google
- 客户端 ID：my-client-id-123456789.apps.googleusercontent.com
- 客户端密钥：my-client-secret-ABCDEF123456
- 刷新令牌：my-refresh-token-ABCDEF123456789
- 原始日历 ID：primary@gmail.com"

查看您即将举行的会议：

"显示我从日历 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d 中即将举行的会议"

安排录制即将举行的会议：

"安排一个机器人录制我的团队会议，事件 ID 为 7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d。
配置机器人：
- 名称：Team Meeting Bot
- 录制模式：gallery_view
- 进入消息：大家好，我来录制会议"

检查日历中安排的所有录音：

"显示我日历中所有安排了录音的会议"

取消先前安排的录制：

"取消事件 7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d 的录制"

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

"强制重新同步我所有连接的日历"

简化的日历集成

为了简化日历集成，您可以直接在 Claude Desktop 配置文件中配置您的日历 OAuth 凭据：

编辑配置文件：

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

将 calendarOAuth 部分添加到您的 botConfig：

"botConfig": {
  // 其他机器人配置...
  
  "calendarOAuth": {
    "platform": "Google",  // 或 "Microsoft"
    "clientId": "YOUR_OAUTH_CLIENT_ID",
    "clientSecret": "YOUR_OAUTH_CLIENT_SECRET", 
    "refreshToken": "YOUR_REFRESH_TOKEN",
    "rawCalendarId": "primary@gmail.com"  // 可选
  }
}

保存文件并重新启动 Claude Desktop - 您的日历将自动集成。

这种方法消除了手动调用 OAuth 设置工具的需要，使日历集成成为一次性配置任务。

**注意：**日历集成是完全可选的。您可以在不连接日历的情况下使用 Meeting BaaS，只需从您的配置中省略 calendarOAuth 部分即可。日历集成通过提供对您即将举行的会议的访问权限并启用日历事件的自动录制来增强体验。

分析会议内容

获取会议的完整文字记录：

"从我的团队会议中获取文字记录，机器人 ID 为 abc-123"

查找会议中的关键时刻：

"识别昨天产品规划会议中的关键时刻，机器人 ID 为 xyz-456"

分享会议中的特定时刻：

"创建一个可共享的链接，指向会议 abc-123 中 John 谈论预算的时间戳 12:45 的部分"

使用直接凭据工具

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

使用直接凭据列出事件：

"使用 API 密钥 tesban 列出日历 5c99f8a4-f498-40d0-88f0-29f698c53c51 中的事件，其中参与者为 philipe@spoke.app"

使用直接凭据安排录制：

"使用 API 密钥 tesban 和机器人名称 'Weekly Meeting Bot' 安排事件 78d06b42-794f-4efe-8195-62db1f0052d5 的录制"

使用直接凭据取消录制：

"使用 API 密钥 tesban 取消事件 97cd62f0-ea9b-42b3-add5-7a607ce6d80f 的录制"

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

"使用 API 密钥 tesban 获取会议 47de9462-bea7-406c-b79a-fd6b82c3de76 的会议数据"

使用 AI 生成的二维码作为机器人头像

生成一个包含您的联系信息和自定义设计的二维码：

"生成一个具有以下参数的二维码：
- 类型：email
- 目标：john.doe@company.com
- 提示：创建一个具有抽象蓝色图案的专业外观二维码，类似于公司徽标
- 样式：style_crystal"

在会议中使用生成的二维码作为机器人头像：

"使用以下参数加入我在 https://zoom.us/j/123456789 举行的 Zoom 会议：
- 机器人名称：QR Code Assistant
- 机器人图像：[来自生成的二维码的 URL]
- 进入消息：大家好，我来录制会议。您可以扫描我的头像以获取我的联系信息。"

生成一个包含会议链接的二维码，以便轻松共享：

"生成一个具有以下参数的二维码：
- 类型：url
- 目标：https://zoom.us/j/123456789
- 提示：创建一个带有日历图标的彩色二维码
- 样式：style_rounded"

访问会议录音

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

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

例如：

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

此查看器提供：

会议视频录音
与发言人识别同步的文字记录
按发言人或主题导航
与队友直接链接共享

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

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

配置

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

主要配置选项：

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

与 Claude Desktop 集成

要与 Claude Desktop 集成：

编辑 Claude Desktop 配置文件：

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

添加 Meeting BaaS MCP 服务器配置：

{
  "mcpServers": {
    "meetingbaas": {
      "command": "/bin/bash",
      "args": [
        "-c",
        "cd /path/to/meeting-mcp && (npm run build 1>&2) && MCP_FROM_CLAUDE=true node dist/index.js"
      ],
      "headers": {
        "x-api-key": "YOUR_API_KEY_FOR_MEETING_BAAS"
      },
      "botConfig": {
        "name": "Meeting Assistant",
        "image": "https://meetingbaas.com/static/972043b7d604bca0d4b0048c7dd67ad2/fc752/previewFeatures.avif",
        "entryMessage": "Hello, I'm a bot from Meeting Baas. I'll be taking notes for this meeting.",
        "deduplicationKey": "unique_key_to_override_restriction",
        "nooneJoinedTimeout": 600,
        "waitingRoomTimeout": 600,
        "speechToTextProvider": "Gladia",
        "speechToTextApiKey": "YOUR_SPEECH_TO_TEXT_API_KEY",
        "extra": {
          "meetingType": "sales",
          "summaryPrompt": "Focus on action items and decision points",
          "searchKeywords": ["budget", "timeline", "deliverables"],
          "timeStampHighlights": [
            {"time": "00:05:23", "note": "Discussion about Q2 sales numbers"},
            {"time": "00:12:47", "note": "Team disagreement on marketing strategy"}
          ],
          "participants": ["John Smith", "Jane Doe", "Bob Johnson"],
          "project": "Project Phoenix",
          "department": "Engineering",
          "priority": "High",
          "followupDate": "2023-12-15",
          "tags": ["technical", "planning", "retrospective"]
        },
        
        // 可选：直接日历 OAuth 集成
        // 仅当您要启用日历集成时才添加此部分
        "calendarOAuth": {
          "platform": "Google",  // 或 "Microsoft"
          "clientId": "YOUR_OAUTH_CLIENT_ID",
          "clientSecret": "YOUR_OAUTH_CLIENT_SECRET",
          "refreshToken": "YOUR_REFRESH_TOKEN",
          "rawCalendarId": "primary@gmail.com"  // 可选 - 特定日历 ID
        }
      }
    }
  }
}

**注意：**将 /path/to/meeting-mcp 替换为您本地存储库的路径，并将 YOUR_API_KEY 替换为您实际的 API 密钥。

**重要提示：**确保您使用的是与您的公司电子邮件帐户关联的 API 密钥。所有录音、机器人日志和共享链接都将自动供具有相同电子邮件域名的同事访问，以实现无缝团队协作。

**关于二维码 API 的说明：**二维码 API 使用与 Meeting BaaS API 相同的标头名称 (x-api-key)，但必须单独配置。对于二维码生成功能，您应该使用下面“二维码 API 密钥配置”部分中描述的方法之一，例如设置环境变量或直接在提示中包含密钥。

重新启动 Claude Desktop。

配置说明：

command 指定要使用的 shell
args 包含命令行参数：
- cd 到您的项目目录
- 构建项目，并将错误输出重定向到 stderr
- 使用 MCP_FROM_CLAUDE=true 环境变量运行服务器，以指示它正在从 Claude Desktop 运行
headers 包含用于身份验证的 API 密钥：
- x-api-key：您的 Meeting BaaS API 密钥，用于访问会议服务
botConfig 允许您自定义机器人的外观和行为：
- name：会议中显示的机器人名称（默认：“Claude Assistant”）
- image：指向可公开访问的图像的 URL，用作机器人的头像（可选）
- entryMessage：机器人加入会议时将发送的消息（可选）
- deduplicationKey：用于覆盖加入同一会议的 5 分钟限制的唯一密钥（可选）
- nooneJoinedTimeout：如果无人加入，机器人离开的超时时间（以秒为单位）（可选）
- waitingRoomTimeout：如果机器人卡在等候室中，机器人离开的超时时间（以秒为单位）（可选）
- speechToTextProvider：用于转录的提供商（“Gladia”、“Runpod”、“Default”）（可选）
- speechToTextApiKey：如果需要，用于语音转文本提供商的 API 密钥（可选）
- calendarOAuth：使用 OAuth 凭据直接集成日历（可选）
  - platform：“Google”或“Microsoft”
  - clientId：您的 OAuth 客户端 ID
  - clientSecret：您的 OAuth 客户端密钥
  - refreshToken：您的 OAuth 刷新令牌
  - rawCalendarId：要集成的特定日历的可选 ID
- extra：关于会议的附加元数据，以增强 AI 功能（可选）
  - 示例：
```
{
  "meetingType": "sales",
  "summaryPrompt": "Focus on action items and decision points",
  "searchKeywords": ["budget", "timeline", "deliverables"],
  "timeStampHighlights": [
    {"time": "00:05:23", "note": "Discussion about Q2 sales numbers"},
    {"time": "00:12:47", "note": "Team disagreement on marketing strategy"}
  ],
  "participants": ["John Smith", "Jane Doe", "Bob Johnson"],
  "project": "Project Phoenix",
  "department": "Engineering",
  "priority": "High",
  "followupDate": "2023-12-15",
  "tags": ["technical", "planning", "retrospective"]
}
```

extra 字段非常灵活 - 您可以添加对您的组织和用例有意义的任何结构化元数据。

与 Cursor 集成

要与 Cursor 集成：

打开 Cursor
转到设置
导航到“模型上下文协议”
添加一个新服务器，其中包含：
- 名称：“Meeting BaaS MCP”
- 类型：“sse”
- 服务器 URL：“http://localhost:7017/mcp”
- 如果需要身份验证，可以选择添加标头

开发

构建

npm run build

使用 MCP Inspector 进行测试

npm run inspect

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

npm run dev

日志管理

服务器包括优化的日志记录，其中包含：

npm run cleanup

此命令：

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

项目结构

src/index.ts：主入口点
src/tools/：工具实现
src/resources/：资源定义
src/api/：Meeting BaaS 后端的 API 客户端
src/types/：TypeScript 类型定义
src/config.ts：服务器配置
src/utils/：实用程序函数
- logging.ts：日志过滤和管理
- tinyDb.ts：持久性机器人跟踪数据库

身份验证

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

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

许可证

MIT

二维码 API 密钥配置

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

直接在提示中：使用 generateQRCode 工具时，直接在提示文本中包含您的 API 密钥，例如，“为我的网站 https://example.com 生成一个二维码，API 密钥为：qrc_your_key”
作为参数：使用 generateQRCode 工具时，将您的 API 密钥作为 apiKey 参数提供
环境变量：设置 QRCODE_API_KEY 环境变量
Claude Desktop 配置：将 API 密钥添加到您的 Claude Desktop 配置文件中，该文件位于：
- Mac/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
示例配置：
```
{
  "headers": {
    "x-api-key": "qrc_your_key_here" 
  }
}
```

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

您可以通过在 QR Code AI API 注册来获取 API 密钥。