seameet-mcp

SeaMeet MCP 服务器（seameet-mcp）是一个让 AI 智能体录制、转写和挖掘会议的 MCP 工具包。一次安装即可在 Claude Code、Claude Desktop、Codex、Antigravity、Cursor、OpenCode、GitHub Copilot CLI、Windsurf 以及任何 MCP 客户端中使用。

【用途与模式】 服务器会自动选择最丰富的可用后端，并暴露两者的并集：

• 桌面模式：当 SeaMeet 桌面应用运行时，智能体可获得完整的录制工具集（开始/停止录制、截图、实时转录、AI 产物、搜索）。无需认证，数据不离开本机。
• 云端模式：当应用不在运行时，智能体读取已同步的资料库（录制、转录、摘要），可上传本地音视频文件进行转录，并通过网络管理 Webhook。授权通过登录网页应用完成，无需复制粘贴密钥，可用于无头终端。

tools/list 返回当前可用工具的超集；可随时调用 seameet_status 查看当前模式。

【主要能力】

1. 录制与捕获（桌面模式）：seameet_start_recording（麦克风、屏幕或屏幕+系统音频）、seameet_stop_recording、seameet_pause_recording / seameet_resume_recording（仅音频暂停/恢复）、seameet_recording_status、seameet_get_live_transcript（录制中读取实时转录）、seameet_take_screenshot。
2. 处理录制内容（桌面=本地文件，云端=同步资料库）：seameet_list_recordings、seameet_list_files、seameet_get_settings；读取生成的产物（摘要、转录、SRT、章节、行动项、关键决策、截图 OCR/描述）——seameet_get_artifact；seameet_search_text 搜索产物文本；seameet_get_asset_bundle 获取资产包清单；seameet_rename_file、seameet_save_artifact、seameet_regenerate_summary、seameet_list_templates。
3. 云端资料库（云端模式）：seameet_list_recent_recordings 列出最近的同步录制（包括在 app.seameet.ai 上转录的文件）；seameet_get_recording 获取摘要、带说话人标注的转录（长录制分页）和章节，以及摘要产生的行动项和关键决策，转录还以与 app.seameet.ai 下载相同的 SRT 或 VTT 文件提供；seameet_get_recordings 一次获取最多 10 个录制的某一部分（摘要、行动项、决策、章节）；seameet_transcribe_file 上传本地音视频文件（mp3、m4a、mp4、mov、wav、flac、ogg、oga、opus、webm、aac、amr、spx；最大 512 MB 和 5 小时）并启动带说话人标注的转录，立即返回 assetId 并告知智能体何时轮询 seameet_get_recording（在本地客户端运行，因此适用于 Claude Code、Codex、Cursor 和 Claude Desktop，但不适用于网页版 claude.ai；使用你的转录配额）；seameet_get_media_url 获取临时媒体流/下载 URL；seameet_search_recordings 搜索你的录制及与你共享的录制（完整片段需要 Sync Pro）；Meeting Memory——seameet_search_memory 查找人物、组织和主题，seameet_get_memory_page 读取带引用会议的 Memory 页面；seameet_whats_changed 按时间顺序（最旧优先）带引用地汇总 2–5 个相关录制；seameet_rename_speakers 重命名说话人、seameet_regenerate_recording_summary 重新生成摘要、seameet_rename_recording 重命名录制；seameet_trash_recordings 将最多 20 个录制移至回收站（30 天内可恢复）、seameet_restore_recordings 恢复、seameet_list_recent_recordings（trashed: true）列出回收站（永久删除仍在 app.seameet.ai 上操作）；seameet_get_usage 检查存储用量、seameet_desktop_recording_help 了解桌面应用录制方法；Webhook 管理——seameet_create_webhook、seameet_list_webhooks、seameet_update_webhook、seameet_delete_webhook（在 ai.ready / recording.synced 上签名投递；创建需要 Sync Pro）。
4. 连接（任意模式）：seameet_status 查看已连接模式，seameet_logout 断开云端/切换账户。

共 17 个桌面工具 + 19 个云端工具（实时获取，新版本自动出现），另有 3 个在客户端运行的工具（seameet_status、seameet_logout、seameet_transcribe_file）。当前后端无法提供的工具会返回清晰的结构化错误，而不是静默失败。

【托管连接器（无需安装）】 SeaMeet 还运行一个托管 MCP 服务器 https://mcp.seameet.ai/mcp。将其作为连接器添加到 Claude 或 ChatGPT 并用 SeaMeet 账户登录（OAuth）：无需 Node.js、无需 npx、无需复制 API 密钥。任何已验证的 SeaMeet 账户均可使用（包括免费版）；Sync Pro 解锁完整搜索片段、完整 Meeting Memory 页面和 Webhook。 选择建议：聊天应用和仅云端使用 → 托管连接器。与 SeaMeet 桌面应用同机的编码智能体，或上传本地文件 → 本包。

【使用方式】 每个客户端运行相同命令——npx -y @seameet/mcp——只是配置格式不同。完整的分工具配方见 INSTALL.md（镜像于 app.seameet.ai/mcp/install.md）。 桌面模式前提：安装并运行 SeaMeet 桌面应用——macOS 用 brew install --cask seameet-ai/tap/seameet，Windows 用 winget install seameet。需要 v3.2.0+；较旧的运行中应用会报告 app_outdated。 云端授权（一次性，无需复制粘贴密钥）：云端模式仅在提供 SEAMEET_API_KEY 或完成设备流程时激活。首次云端工具调用且无密钥时，智能体会显示一个短代码 + https://app.seameet.ai/link；你打开它（已登录）、点击 Authorize，一个读写密钥即被铸造并缓存到 ~/.seameet/credentials.json。此后静默运行；可随时在账户的 API keys 下撤销。要断开或切换账户，调用 seameet_logout（或 rm ~/.seameet/credentials.json）。 上传大文件：seameet_transcribe_file 以 8 MB 分片上传并发送阶段通知（notifications/progress：读取文件、检查配额、每个分片开始和完成、完成上传、开始转录），每秒最多一次。宿主若在进度时重置工具超时则会持续等待，但停滞的传输不发送任何内容；不重置的宿主可能中断长上传：在 Claude Code 中可提高大文件的工具超时，例如 MCP_TOOL_TIMEOUT=600000 claude（10 分钟）。转录本身在工具返回后在云端运行，因此只有上传计入。文件在发送前打开一次，每个分片都从该打开文件读取。若在上传期间被重写、增长或替换，上传会以 file_changed 停止，而不是发送新旧字节的混合。头部显示超过 5 小时的录制会在发送前被拒绝。

【Claude Desktop 一键包与 Claude Code 插件】 manifest.json 是 MCPB 包清单，服务器以一键 Claude Desktop 扩展形式发布：通过 Settings → Extensions → Advanced → Install extension… 安装并选择 dist/seameet.mcpb，Claude Desktop 用自带 Node.js 运行，无需终端（桌面模式仍需桌面应用安装并运行）。 本仓库同时是 Claude Code 插件市场。该插件注册 MCP 服务器和一个 /seameet 技能，教授核心工作流（录制+转录、捕获 bug 报告、从会议中挖掘行动项）。

【架构与限制】 一个薄 stdio↔HTTP 代理。SeaMeet 桌面应用托管一个仅限本机的桥接（127.0.0.1:3741，回退 3742/3743），用每次启动的随机密钥认证；启动时它将凭据写入 $TMPDIR/seameet-mcp-bridge-<username>.json（权限 0600），本服务器读取并代理（tools/list → GET /mcp-bridge/tools，tools/call → POST /mcp-bridge/call-tool）。桌面模式下数据不离开本机。云端模式通过 HTTPS 与托管 SeaMeet worker（与托管连接器同一服务器）通信，使用铸造的密钥。每个发往 SeaMeet 云端的请求都带有 User-Agent: seameet-mcp/<version>。 完整工具参考（供 LLM）：seameet.ai/llms.txt——应用运行时也在本地 http://localhost:3741/llms.txt 提供。错误是机器可读的：工具失败返回结构化 JSON 供智能体分支处理。 发布自动化——见 PUBLISHING.md。许可：MIT © SeaMeet.ai。条款 https://seameet.ai/en/terms/，隐私 https://seameet.ai/en/privacy/。