官方 tl;dv API 的 MCP 服务器

🚀 首个也是唯一一个支持 Google Meet、Zoom 和 Microsoft Teams 集成的 MCP 服务器

该项目提供了一个模型上下文协议（MCP）服务器，能够与 tl;dv API 无缝交互。作为视频会议平台的首个 MCP 解决方案，它通过标准化接口解锁了 tl;dv 的会议智能功能，涵盖了 Google Meet、Zoom 和 Microsoft Teams。这种集成允许 AI 模型和 MCP 客户端以统一的方式访问、分析并从所有主要平台上的会议中提取见解。

功能

• 列出会议： 根据过滤器（查询、日期范围、参与状态、类型）检索所有支持平台上的会议。
• 获取会议元数据： 无论会议是在哪个平台上举办的，都可以通过 ID 获取特定会议的详细信息。
• 获取会议记录： 对于任何会议 ID，都能以跨平台一致的格式获取会议记录。
• 获取亮点： 从任何支持的平台上获取由 AI 生成的会议亮点。
• 导入会议（即将推出）： 通过 URL 从任何支持的平台上导入会议的功能。

前提条件

• tl;dv 账户： 需要 Business 或 Enterprise 级别的 tl;dv 账户。
• tl;dv API 密钥： 您需要一个 API 密钥，可以从您的 tl;dv 设置中请求获得: https://tldv.io/app/settings/personal-settings/api-keys。
• Node.js & npm (用于 Node 安装)： 如果通过 Node.js 安装，请确保已安装 Node.js 和 npm。
• Docker (用于 Docker 安装)： 如果通过 Docker 安装，请确保已安装并运行 Docker。

安装与配置

您可以使用 Docker 或 Node.js 运行此 MCP 服务器。配置您的 MCP 客户端（例如 Claude Desktop, Cursor）以连接到服务器。

使用 Docker

进入仓库目录。

1. 构建 Docker 镜像：

   docker build -t tldv-mcp-server .
   

2. 配置您的 MCP 客户端：
   更新您的 MCP 客户端配置文件（例如 claude_desktop_config.json）。具体位置和格式可能因客户端而异。

   {
       "mcpServers": {
         "tldv": {
           "command": "docker",
           "args": [
               "run",
   
               "--rm",        
               "--init",      
               "-e",          
               "TLDV_API_KEY=<your-tldv-api-key>",
               "tldv-mcp-server"
           ],
         }
       }
     }
   

   将 <your-tldv-api-key> 替换为您的实际 tl;dv API 密钥。

使用 Node.js

1. 安装依赖项：

   npm install
   

2. 构建服务器：

   npm run build
   

   此命令会创建一个包含已编译服务器代码 (index.js) 的 dist 文件夹。

3. 配置您的 MCP 客户端：
   更新您的 MCP 客户端的配置文件。

   {
     "mcpServers": {
       "tldv": {
         "command": "node",
         "args": ["/absolute/path/to/tldv-mcp-server/dist/index.js"],
         "env": {
           "TLDV_API_KEY": "your_tldv_api_key"
         }
       }
     }
   }
   

   将 /absolute/path/to/tldv-mcp-server/dist/index.js 替换为正确的已构建服务器文件的绝对路径，并将 your_tldv_api_key 替换为您的 tl;dv API 密钥。

请参考您特定的 MCP 客户端文档以获取详细的设置说明（例如，Claude Tools）。

免责声明 在更新此配置文件后，您需要终止您的 MCP 客户端并重新启动它以使更改生效。

开发

1. 安装依赖项：

   npm install
   

2. 设置环境变量：
   复制示例环境文件：

   cp .env.example .env
   

   编辑 .env 文件并添加您的 TLDV_API_KEY。其他变量可根据需要进行配置。

3. 在开发模式下运行：
   此命令会在文件更改时自动重新加载服务器：

   npm run watch
   

4. 更新客户端以支持本地开发：
   配置您的 MCP 客户端以使用本地开发服务器路径（通常是 /path/to/your/project/dist/index.js）。确保 TLDV_API_KEY 是可访问的，可以通过客户端的 env 配置或通过服务器进程加载的 .env 文件来实现。

5. 重新加载您的 MCP 客户端
   由于您正在运行 watch 命令，它会重新编译一个新的版本。重新加载您的客户端（例如 Claud 桌面应用程序），您的更改将生效。

调试

• 控制台日志： 运行 npm run dev 时检查控制台输出以获取详细日志。服务器使用了 debug 库；您可以使用环境变量（例如 DEBUG=tldv-mcp:*）控制日志级别。
• Node.js 调试器： 使用标准 Node.js 调试工具（例如 Chrome DevTools Inspector、VS Code 调试器）通过适当的标志（例如 node --inspect dist/index.js）启动服务器进程。
• MCP 客户端日志： 检查您的 MCP 客户端提供的日志，这些日志可能显示从该服务器发送和接收的请求及响应。

了解更多

• tl;dv 开发者 API 文档
• 模型上下文协议 (MCP) 规范