← 返回目录

Funasr MCP

官方

使用 FunASR 在本地私密转写音频。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 101 / 230
Stars: ★ 20.7k 非常热门
传输方式: stdio（本地进程）
运行环境: Docker
凭据: 无需凭据
许可证: MIT
最近提交: 9 天前

56FMRS · C

这是 FunASR 上游仓库中的官方 MCP 服务清单，版本为 0.1.2，采用 Docker 和 stdio，定位是本地私密音频转写。清单未声明工具名称，因此工具级能力和调用参数无法进一步核实。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

14/20

文档质量

12/20

安装易用性

10/20

查看各项评分依据

可靠性 9/20: 静态证据显示存在版本化的 OCI Docker 包、stdio 传输和明确的音频目录挂载，正常启动路径看起来可行。但未提供 MCP 服务端源码、工具清单、初始化/工具列表握手证据、测试或 CI；错误处理、依赖失败和工具行为无法验证，因此扣分。
安全与权限 11/20: 音频目录以只读方式挂载，模型缓存独立持久化，且描述为本地推理；未见凭据、删除、支付、部署或远程命令默认行为，也未见真实秘密。可是模型会下载外部文件，镜像来源、网络数据流、工具权限边界、敏感音频处理和确认机制均未充分说明，因此扣分。
维护活跃度 14/20: 仓库未归档，明确标注 MIT 许可证，维护主体和仓库地址清晰；README 列出截至 2026-07-24 的连续 PyPI、运行时和功能发布，显示近期维护活动。缺少可核验的提交历史、CI、漏洞响应渠道、依赖更新政策和明确支持承诺，因此未给满分。
文档质量 12/20: README 提供安装、Docker 挂载、模型选择、平台限制、部署方式、许可证差异和多种使用示例，整体覆盖较广。MCP 专用文档缺少可审查的工具参数、返回结构、错误处理、客户端配置、资源限制和隐私/网络说明，且无法由所给材料验证服务实现与文档完全一致，因此扣分。
安装易用性 10/20: 清晰给出了 OCI 镜像、stdio 传输、必需的音频目录挂载和模型缓存卷，理论上可接入支持 stdio 的客户端。缺少 Claude/Cursor 等客户端的实际配置示例、启动日志或连接验证，且需要 Docker、主机路径配置及模型下载，平台兼容性和首次运行失败处理不够明确，因此扣分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件

适合谁

需要本地或私密音频转写的用户
已经使用 Docker、Claude 或 Cursor 的用户
需要使用 FunASR 或 SenseVoice 模型的场景

不适合谁

需要已声明工具列表或明确 MCP 工具调用契约的集成方
需要云端托管转写服务的用户
需要仅依据 MIT 代码许可证使用所有预训练模型权重的用户

所需权限

需要读取被挂载主机音频目录中的音频文件
需要向 ModelScope 模型缓存卷写入下载的模型文件
容器内需要访问 /audio 下的音频路径

风险与副作用

主机音频目录会暴露给容器读取，但挂载配置为只读
模型文件会下载并保存在 ModelScope 缓存卷中
FunASR 工具包为 MIT 许可，但预训练模型权重可能有单独许可证，需查看对应模型卡
清单未列出具体工具名称，因此无法据此确认可用操作范围

安装接入

准备工作

运行环境：Docker

使用 Docker 运行 ghcr.io/modelscope/funasr-mcp:0.1.2，并将包含音频文件的主机目录以只读方式挂载到容器的 /audio；调用时使用 /audio/<file> 路径。将名为 funasr-mcp-cache 的 Docker 卷挂载到 /root/.cache/modelscope，以持久化下载的 ModelScope 模型文件。

验证是否装好

在客户端中连接该服务器后，向它发送一条转写 /audio 目录下某个音频文件的请求，返回的识别文本即证明 MCP 服务器正常运行。

常见排障

确认主机音频目录已挂载到容器的 /audio
调用时使用 /audio/<file>，而不是主机路径
确认 Docker 镜像版本为 0.1.2
检查 funasr-mcp-cache 卷是否正确挂载，以便复用已下载模型文件
确认音频文件位于所挂载目录中

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把 /audio/sample.wav 转写成文字
用 SenseVoice 识别挂载目录里的这段录音
转写 /audio/meeting.wav 并输出带时间戳的文本

使用场景

在本地转写音频文件

将 FunASR 的语音识别能力接入 Claude 或 Cursor

在不将音频发送到云端的情况下进行设备端推理

支持客户端

Claude部分支持

Cursor部分支持

依据项目文档列出，未经本站实测。

详细介绍

FunASR MCP Server 是 FunASR 项目提供的 MCP 服务，通过 SenseVoice 和 FunASR 在设备本地转写音频。FunASR 工具包还支持流式 ASR、VAD、标点、说话人分离、情感识别和音频事件模型，但该服务器清单未声明具体工具名称。服务使用 Docker OCI 镜像并通过 stdio 通信。