Wisprs

Wisprs AI 连接器

面向 ChatGPT、Codex、Claude Code 和远程 MCP 客户端的官方 Wisprs 分发包。Wisprs 是托管式远程 MCP 服务：转录音频、视频和公开媒体链接，然后搜索、总结、翻译并导出转录文本。本仓库包含客户端配置、插件清单和技能；服务本身运行在 wisprs.co。

经过身份验证的 Streamable HTTP 端点（OAuth 2.1）如下：

• ChatGPT：https://wisprs.co/api/mcp（23 个工具，包括用于聊天中附加文件的 transcribe_file，以及内嵌转录卡片）。
• Claude 连接器和插件：https://wisprs.co/api/mcp/claude（STT 和其他非 TTS 工作流；39 个工具）。
• Codex 和其他直连 MCP 客户端：https://wisprs.co/api/mcp（通用接口；43 个工具，包括 TTS）。
• 浏览器设置指南：https://wisprs.co/mcp/setup。

已列入官方 MCP Registry，条目为 co.wisprs/wisprs（参见 server.json）。

Claude 版本支持转录、资料库、会议、创作者、支持和开发者工作流：

• transcribe_url 从公开 HTTPS 媒体 URL 启动异步转录。
• get_private_media_upload_handoff 打开经过身份验证的 Wisprs 上传器，以处理本地或私有媒体；不会通过模型发送文件字节或上传令牌。
• get_job_status 检查持久化操作状态，不会创建重复任务。
• get_transcript 以有界的游标分页方式获取已完成的转录文本。
• get_transcript_artifact 以有界分页方式获取生成内容。
• search_library 在已连接租户的资料库中查找排序后的片段。
• export_transcript 将转录文本导出为 TXT、SRT、VTT、JSON、Markdown 或 DOCX，并生成私有的、有时效限制的 MCP 资源。
• summarize_transcript 和 generate_chapters 可创建可重复使用的结构化内容。
• repurpose_transcript 可创建节目说明、帖子串、博客草稿或引文选集。
• translate_transcript 可创建可重复使用的特定语言内容。

服务端负责身份验证、授权、租户隔离、幂等性、速率限制、成本控制、审计记录和数据保留。本仓库不包含任何 Wisprs 服务源代码、凭据或客户数据。

为 Claude Code 安装

测试本地检出版本：

claude --plugin-dir ./wisprs-ai-connectors/claude

或者将此仓库添加为市场：

/plugin marketplace add Wisprs/wisprs-ai-connectors
/plugin install wisprs-ai-connectors@wisprs-plugins

在 Claude Code 中运行其 /mcp 命令，在浏览器中完成 OAuth。请勿将令牌粘贴到仓库、提示词或配置文件中。

为 ChatGPT 和 Codex 安装

Wisprs 已发布在 ChatGPT 的应用目录中：搜索 Wisprs，连接并登录。附加录音或粘贴链接，然后请求转录文本；转录卡片会在聊天中显示处理进度和完成后的文本。

.codex-plugin/plugin.json 清单使用 .mcp-openai.json 和通用端点，供 Codex 使用。任何其他 MCP 客户端都可以直接连接到 https://wisprs.co/api/mcp，并在浏览器中完成 OAuth。

直接配置 MCP

Claude 宿主使用 claude/.mcp.json（Claude 插件位于 claude/ 中，该目录仅包含其清单、MCP 配置、技能和图标）。其他宿主可以使用 .mcp-openai.json 访问通用端点。每个端点都会返回 OAuth 受保护资源元数据，并启动浏览器授权流程。此软件包不需要也不接受静态 bearer 令牌。

正确的异步用法

1. 告知用户转录会启动计费的异步任务；如果宿主尚未征得确认，请先获取用户确认。
2. 为此逻辑请求生成一个不透明的幂等键。
3. 调用一次 transcribe_url，并保留其 operationId。
4. 按照 retryAfterSeconds 指定的间隔或更长时间轮询 get_job_status。
5. 状态变为 completed 后，使用返回的不透明 transcriptionId 调用 get_transcript。
6. 严格按照 nextCursor 继续获取，并说明响应是否为部分内容。

对于导出和 AI 转换，请使用一个稳定的幂等键，轮询返回的操作，然后读取确切的导出资源 URI，或使用已完成结果的元数据调用 get_transcript_artifact。MCP 资源可用时，切勿将大型导出内容直接放入对话上下文。

如果 transcribe_url 调用的结果不明确，切勿使用新的幂等键重试。这可能会产生重复的计费任务。

开发

要求：Node.js 22 或更高版本；进行宿主验证时，还需要使用当前版本的 Claude Code 和 Codex 工具。

npm test
npm run validate
npm run package

npm run validate:live-links 还会通过 HTTPS 验证公开的政策和支持链接。特定宿主的测试用例和发布门槛见 docs/HOST_COMPATIBILITY.md 和 docs/REVIEWER_GUIDE.md。

安全与隐私

报告漏洞前，请阅读 SECURITY.md；有关此软件包的数据边界，请阅读 PRIVACY.md。服务政策发布于 wisprs.co/privacy 和 wisprs.co/terms。

发布状态

版本 0.30.0。已发布到 ChatGPT 的应用目录和官方 MCP Registry；Claude 目录中的条目正在审核中。有关兼容性和来源信息，请参阅 CHANGELOG.md 和 release.json。

许可证

MIT。请参阅 LICENSE。