mcp-asr

# mcp-asr `mcp-asr` 是一个 stdio MCP 语音转写服务，用于调用 OpenAI-compatible transcription 接口： ```text Claude / Codex / Agent → stdio MCP → OpenAI-compatible ASR ``` 支持普通转写、纯文本输出，以及会议/访谈的说话人对话输出。 ## 公共配置 | 配置 | 必填 | 说明 | |---|---:|---| | `--url` / `MCP_ASR_URL` | 是 | transcription 完整 URL | | `--model` / `MCP_ASR_MODEL` | 是 | 普通模型，支持上游 `json` | | `--dialogue-model` / `MCP_ASR_DIALOGUE_MODEL` | dialogue 模式必填 | 支持 `verbose_json` 和 speaker segments 的模型 | | `--default-output-format` / `MCP_ASR_DEFAULT_OUTPUT_FORMAT` | 否 | 默认输出形式：`text`、`json` 或 `dialogue`，默认 `json` | | `MCP_ASR_TOKEN` | 是 | 上游 Token，只从环境变量读取 | 启动参数优先于环境变量。一个模型同时支持普通和说话人转写时，可以把 `--model` 和 `--dialogue-model` 配置为同一个模型名称。 文件是否可访问由宿主沙箱、操作系统权限和 MCP 客户端的用户授权决定； `mcp-asr` 本身不额外弹出文件授权确认。 ## 通过 PyPI 使用 ### 安装 ```bash python3 -m venv .venv .venv/bin/pip install mcp-asr ``` ### 手工运行 ```bash MCP_ASR_TOKEN='your-token' \ .venv/bin/mcp-asr \ --url https://api.example.com/v1/audio/transcriptions \ --model normal-asr-model \ --dialogue-model speaker-asr-model \ --default-output-format json ``` ### Claude Code ```json { "mcpServers": { "speech-to-text": { "type": "stdio", "command": "/absolute/path/to/.venv/bin/mcp-asr", "args": [ "--url", "https://api.example.com/v1/audio/transcriptions", "--model", "normal-asr-model", "--dialogue-model", "speaker-asr-model", "--default-output-format", "json" ], "env": { "MCP_ASR_TOKEN": "your-token" }, "timeout": 240000 } } } ``` ### Codex ```toml [mcp_servers.speech-to-text] command = "/absolute/path/to/.venv/bin/mcp-asr" args = [ "--url", "https://api.example.com/v1/audio/transcriptions", "--model", "normal-asr-model", "--dialogue-model", "speaker-asr-model", "--default-output-format", "json", ] enabled = true startup_timeout_sec = 20 tool_timeout_sec = 240 [mcp_servers.speech-to-text.env] MCP_ASR_TOKEN = "your-token" ``` ## 通过 npx 使用 np…