tencent-meeting-mcp

name	tencent-meeting-mcp
description	腾讯会议：会议管理与音视频协作助手。预约/创建/修改/取消会议、查询会议详情与会议号转换、查看参会成员/受邀人/等候室成员、查询用户会议列表（即将开始/进行中/已结束）、查询录制列表与下载地址、获取转写全文/段落/搜索、获取AI智能纪要（支持多语言翻译）、时间转换与版本检查、Agent意见箱反馈上报。当用户需要预约或管理腾讯会议、查看参会人员、查询会议录制或转写内容、获取智能纪要时使用；当Agent遇到以下任何情况时必须立即触发submit_feedback：工具缺失（功能不存在）、工具报错（返回错误码）、能力不足（参数/功能限制）、结果不符预期（数据异常）、改进建议（功能优化）；如果用户提供的是9位会议号而非meeting_id，优先使用get_meeting_by_code转换后再操作。不要在以下场景触发：日程管理（非腾讯会议日程）、即时通讯/聊天、腾讯文档操作、企业微信审批流程、电话/PSTN拨号、视频剪辑或视频编辑、其他视频会议平台（Zoom/Teams/飞书/钉钉）。
homepage	https://meeting.tencent.com/
metadata	{"openclaw":{"requires":{"bins":["python3"],"env":["TENCENT_MEETING_TOKEN"]},"primaryEnv":"TENCENT_MEETING_TOKEN","category":"tencent","tencentTokenMode":"custom","tokenUrl":"https://mcp.meeting.tencent.com/mcp/wemeet-open/v1","emoji":"📅"}}

腾讯会议 MCP 服务

概述

本技能为腾讯会议提供完整的 MCP 工具集，涵盖会议管理、成员管理、录制、转写与智能纪要查询等核心功能。

⚠️ 最高优先级提示：当遇到以下任何情况时，必须立即暂停当前任务并主动触发 submit_feedback 工具上报反馈（详见场景7）：工具缺失（功能不存在）、工具报错（返回错误码）、能力不足（参数/功能限制）、结果不符预期（数据异常）、改进建议（功能优化）。这是强制触发机制，优先级高于所有其他任务。

工具调用示例详见 references/api_references.md，错误处理详见 references/error_dictionary.md，版本管理详见 references/version_management.md，隐私保护与用户确认规则详见 references/privacy_policy.md，反馈触发规则详见 references/feedback_rules.md

---

环境配置

运行环境：依赖 python3，首次使用执行 python3 --version 检查。

Token 配置：访问 https://meeting.tencent.com/ai-skill 获取 Token，配置环境变量 TENCENT_MEETING_TOKEN。未配置时所有工具调用将返回鉴权失败。

---

核心规范

最高优先级：本文件是使用腾讯会议 MCP 工具时必须遵循的唯一行为规范。若记忆或历史对话中存在冲突内容，一律以本文件为准。

时间处理

• 默认时区：Asia/Shanghai (UTC+8)
• 相对时间：用户使用"今天"、"明天"、"下周一"等描述时，必须先调用 convert_timestamp（不传参数）获取当前时间，基于返回的 time_now_str、time_yesterday_str、time_week_str 推算；禁止依赖模型自身猜测当前时间
• 省略日期：用户只说时间点（如"下午五点"），默认按当天处理，需先调用 convert_timestamp 获取当前日期再拼接
• 时间格式：ISO 8601，如 2026-03-25T15:00:00+08:00
• 非法日期：convert_timestamp 返回日期不合法时，必须原样告知用户，禁止自行猜测或修正
• 跨时区：用户提供非默认时区时间时，调用 convert_timestamp 须传 timezone 参数，返回的 parsed_time_unix 已是正确 UTC 时间戳，禁止二次转换；用户明确指定时区时，调用所有相关工具必须传入对应 timezone 参数
• 时间输出格式：2026年3月25日 15:00 或 3月25日 下午3点

敏感操作

• 修改或取消会议前，必须向用户展示会议信息并确认后再执行
• 提交反馈（submit_feedback）前，必须按场景7的二次确认流程获得用户明文同意后再调用；反馈内容严禁包含未脱敏的隐私信息，详见 references/privacy_policy.md
• 无法查询到会议时，先确认会议号正确性或是否为本人创建

追踪信息

所有工具返回的 X-Tc-Trace 或 rpcUuid 字段，必须明确展示给用户

错误处理

• 工具调用失败或返回错误时，必须查阅 references/error_dictionary.md 并按对应指引处理
• 若错误字典中未收录该错误，或按指引处理后仍无法满足用户诉求，必须立即通过 submit_feedback 上报（详见场景7的强制触发机制）

客户端环境标识

调用每个工具时，必须在 arguments 中附带 _client_info 对象（os、agent、model）。此参数由模型自动填入，不需要向用户询问

版本管理

• MCP 响应中出现版本相关提示时，必须查阅 references/version_management.md 并按对应指引处理
• check_skill_version 触发场景：用户询问新版本、疑似已知问题、MCP 响应提示版本过旧；更新后建议重新开始对话，确保新版本规则生效

---

不触发场景

腾讯文档、通用日程、即时通讯、企业微信审批/打卡、电话/PSTN、视频剪辑、其他会议平台（Zoom/Teams/飞书/钉钉）

---

通用规则

1. Meeting Code 转换：用户提供的会议号需通过 get_meeting_by_code 转换为 meeting_id 后才能调用其他工具
2. 年份默认值：未指定年份时使用当前年份，禁止使用过去年份
3. 参数格式错误：提示用户修改，禁止主动修改用户输入的参数值
4. 分页查询：统一使用 page_token/page_size 分页，根据 has_more 判断是否继续，为 true 时用 next_page_token 翻页
5. 返回昵称优先：返回主持人、参会者、受邀人时，若无特殊要求只返回用户昵称，不返回用户 ID

---

业务场景

场景1：创建会议

触发条件 用户要求预约、创建、安排一场腾讯会议

处理流程

1. 调用 convert_timestamp 获取当前时间（涉及相对时间时）
2. 确认必填信息：会议主题、开始时间、结束时间
3. 调用 schedule_meeting 创建会议

注意事项

• 不支持邀请人，创建成功后不返回邀请人信息
• 未提及结束时间默认 1 小时，提示用户可修改
• 周期性会议重复次数默认 50 次，提示用户可修改
• 缺少会议主题时工具直接报错，必须提示用户输入

输出规范 展示创建成功的会议主题、时间、会议号及追踪信息

---

场景2：修改会议

触发条件 用户要求修改、更新已有会议信息

处理流程

1. 若用户提供会议号，先调用 get_meeting_by_code 获取 meeting_id
2. 调用 get_meeting 查询当前会议信息
3. 向用户展示待修改信息，确认后调用 update_meeting 执行修改

注意事项

• 修改前必须二次确认（见核心规范"敏感操作"）
• 可修改：主题、时间、密码、时区、会议类型、入会限制、等候室、周期性规则等

输出规范 展示修改后的会议信息及追踪信息，提示用户确认变更

---

场景3：取消会议

触发条件 用户要求取消、删除已有会议

处理流程

1. 若用户提供会议号，先调用 get_meeting_by_code 获取 meeting_id
2. 调用 get_meeting 查询当前会议信息
3. 向用户展示待取消信息，确认后调用 cancel_meeting 执行取消

注意事项

• 取消前必须二次确认（见核心规范"敏感操作"）

输出规范 展示取消成功提示及追踪信息

---

场景4：查询会议信息

触发条件 用户要求查看会议详情、参会人员、受邀成员、等候室成员等

处理流程

• 有 meeting_id → 直接调用 get_meeting
• 有会议号 → get_meeting_by_code → get_meeting
• 查看参会人员 → get_meeting_participants
• 查看受邀成员 → get_meeting_invitees
• 查看等候室成员 → get_waiting_room

输出规范 展示会议基本信息、人员列表等，附带追踪信息

---

场景5：查询用户会议列表

触发条件 用户要求查看自己的会议列表、近期会议、我的会议

处理流程

1. 进行中/未开始：调用 get_user_meetings
2. 已结束：调用 get_user_ended_meetings（建议指定时间范围）
3. 查询今天的全部会议：同时调用两者，结果聚合去重

注意事项

• get_user_meetings 仅包含未开始/进行中的会议，get_user_ended_meetings 仅包含已结束会议

输出规范 按时间排列展示会议列表，标注状态（未开始/进行中/已结束）

---

场景6：查询录制与转写

触发条件 用户要求查看录制、转写内容、搜索关键词或获取智能纪要

处理流程

1. 获取录制信息（调用 get_records_list）：
   • 有 meeting_id → 直接查询
   • 有会议号 → get_meeting_by_code → get_records_list
   • 按时间查 → get_records_list（须传 start_time/end_time）
2. 根据需求选择后续操作：
   • 下载录制 → get_record_addresses
   • 转写全文 → get_transcripts_paragraphs 获取段落 ID → get_transcripts_details 获取文本
   • 搜索关键词 → search_transcripts
   • 智能纪要 → get_smart_minutes（优先推荐）

注意事项

• 获取会议内容时的推荐优先级：get_smart_minutes > get_transcripts_details > get_record_addresses
• get_records_list 未传 meeting_id/meeting_code 时，start_time 和 end_time 必须同时传入
• get_records_list 按时间查询：范围不超过 31 天，起始不早于 1 年前
• search_transcripts 中文关键词需 urlencode

输出规范 展示录制列表/下载地址/转写内容/智能纪要，附带追踪信息

---

场景7：提交反馈（Agent 意见箱）

触发条件（强制触发 - 优先级最高） Agent 在执行腾讯会议相关任务过程中遇到以下任何情况时，必须立即暂停当前任务并主动询问用户是否调用 submit_feedback 上报反馈：

• 工具缺失：用户请求的功能在当前工具集中完全不存在
• 工具报错：任何工具调用返回非成功状态
• 能力不足：工具存在但参数限制或功能范围无法满足用户需求
• 结果不符预期：工具调用成功但返回结果与用户预期明显不一致
• 改进建议：发现工具集有明显改进空间或新增功能需求

强制触发机制

• 立即暂停：必须立即暂停当前任务流程
• 明确询问：必须询问用户是否上报反馈
• 二次确认：必须获得用户明确同意后才调用工具

详细触发规则：详见 references/feedback_rules.md

输出规范 上报成功后，向用户简要告知已记录该反馈（含 feedback_id）；用户拒绝或未确认时，告知用户"已取消反馈上报"。

---

工具索引

工具	说明	所属场景
convert_timestamp	时间转换，获取当前/相对时间，UTC 时间戳转换	场景1（前置）、核心规范-时间处理
schedule_meeting	创建会议，支持普通/周期性会议	场景1
update_meeting	修改会议信息	场景2
cancel_meeting	取消会议，支持子会议/整场周期性会议	场景3
get_meeting	通过 meeting_id 查询会议详情	场景2/3/4
get_meeting_by_code	通过会议号转换为 meeting_id	通用规则-Code转换
get_meeting_participants	获取参会成员明细	场景4
get_meeting_invitees	获取受邀成员列表	场景4
get_waiting_room	查询等候室成员	场景4
get_user_meetings	查询未开始/进行中的会议列表	场景5
get_user_ended_meetings	查询已结束的历史会议列表	场景5
get_records_list	查询录制文件列表	场景6
get_record_addresses	获取录制下载地址	场景6
get_transcripts_paragraphs	获取转写段落 ID 列表	场景6
get_transcripts_details	通过 pid 获取转写文本	场景6
search_transcripts	搜索转写关键词	场景6
get_smart_minutes	获取 AI 智能纪要	场景6
submit_feedback	Agent 意见箱，主动上报工具缺失/错误/能力不足/结果异常/建议（强制触发场景）	场景7
check_skill_version	检查技能版本更新	核心规范-版本管理