内容
# STT.ai MCP 服务器
适用于 [STT.ai](https://stt.ai) 的模型上下文协议服务器。允许 Claude Desktop、Cursor 和其他任何兼容 MCP 的客户端对音频/视频进行转录，管理转录记录，并在其上运行 AI 功能。
**与其他 STT MCP 服务器（Otter、Fireflies、Granola、Read AI）的区别：** 这些服务器仅对存储的转录记录可读。此服务器还提供了 `transcribe_url` 和 `chat_with_transcript` 功能，因此 Claude 可以转录 YouTube 链接并立即查询结果在一个对话中。
## 工具列表
| 工具 | 功能描述 |
|---|---|
| `list_transcripts` | 列出过去的转录记录（分页，可按状态筛选） |
| `get_transcript` | 获取一份转录记录，包含分段、发言人、摘要、元数据 |
| `export_transcript` | 导出为文本/srt/vtt/json/csv |
| `transcribe_url` | 下载并转录任意 URL（YouTube、播客、直接文件） |
| `summarize_transcript` | AI 摘要（缓存或重新生成） |
| `analyze_transcript` | 情感分析、话题、实体、行动项、问题、个人身份信息 |
| `generate_from_transcript` | 生成博客文章、社交媒体、学习指南、闪存卡等 |
| `chat_with_transcript` | 与转录记录进行 RAG 问答，附带来源引用（分段 ID + 时间戳） |
| `list_models` | 可用的转录模型，附带 WER 基准测试 |
| `list_languages` | 支持的语言 |
## 安装
```bash
pip install sttai-mcp
```
## 配置
在 https://stt.ai/account/#developer 获取您的 STT.ai API 密钥。
### Claude Desktop
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"stt-ai": {
"command": "sttai-mcp",
"env": {
"STT_API_KEY": "your-api-key-here"
}
}
}
}
```
重启 Claude Desktop。STT.ai 工具应该会出现。
### Cursor
设置 → MCP → 添加新的 MCP 服务器：
```json
{
"stt-ai": {
"command": "sttai-mcp",
"env": { "STT_API_KEY": "your-api-key-here" }
}
}
```
### 直接运行
```bash
STT_API_KEY=your-key sttai-mcp
```
服务器通过标准输入/输出与 MCP 通信。
## 示例
在 Claude Desktop 中，配置完成后：
> "转录 https://www.youtube.com/watch?v=dQw4w9WgXcQ 并总结关键点。"
Claude 将调用 `transcribe_url`，然后对结果调用 `summarize_transcript`。
> "我的最近 5 条转录记录是什么？"
Claude 调用 `list_transcripts(limit=5)` 并读取每个标题。
> "在转录记录 abc123 中，发言人说了什么关于定价的内容？"
Claude 调用 `chat_with_transcript("abc123", "what did they say about pricing?")` 并获取带有时间戳来源的答案。
## 仓库
- 源码：https://github.com/sttaigit/sttai-mcp
- 许可证：MIT
- 问题：https://github.com/sttaigit/sttai-mcp/issues
由 [STT.ai](https://stt.ai) 维护。
