内容
# Notta MCP 桌面扩展
Notta MCP 是适用于 Claude Desktop 的本地 Model Context Protocol 服务器。它允许 Claude 上传允许的本地音频/视频文件到 Notta 进行转录，然后列出、搜索、查看和检查 Notta 转录记录。
该项目被打包为 Claude Desktop 扩展（`.mcpb`）。它使用本地 `stdio` 传输，因此 Claude Desktop 将服务器启动为本地 Node.js 进程。
## 桌面扩展安装
构建和打包扩展：
```bash
npm ci
npm run build
npm run mcpb:pack
```
从设置 > 扩展 > 安装扩展，在 Claude Desktop 中安装生成的 `.mcpb` 文件。
在安装过程中，选择 Notta 允许读取文件的本地文件夹。`transcribe` 工具拒绝文件夹外的文件路径，并拒绝大于 2 GB 或长于 4 小时的文件。
## 首次身份验证
安装扩展后，请 Claude 运行 `auth_setup` 工具。它在您的浏览器中打开 Notta 授权页面，并在以下位置保存凭证：
```text
~/.config/notta_cli/credentials.json
```
凭证目录仅限 `0700`，凭证文件仅限 `0600`，临时 S3 上传凭证仅保存在内存中。
身份验证成功后，请重试 Notta 操作。
## 可用工具
| 工具 | 访问权限 | 描述 | 参数 |
|------|--------|-------------|------------|
| `auth_setup` | 写入本地凭证 | 在浏览器中启动 Notta OAuth 流程。 | `port` |
| `transcribe` | 上传/创建 | 上传允许的本地音频/视频文件并启动转录。 | `file`，`language` |
| `status` | 只读 | 检查 Notta 记录的转录状态。 | `record_id`，`wait` |
| `view` | 只读 | 获取 Notta 记录的转录结果。 | `record_id` |
| `search` | 只读 | 按关键词搜索 Notta 记录。 | `keyword`，`page`，`page_size` |
| `list` | 只读 | 列出 Notta 记录和文件夹。 | `group_id`，`page`，`page_size`，`order_by`，`order_type` |
## 支持的媒体格式
`wav`、`mp3`、`m4a`、`caf`、`aiff`、`avi`、`rmvb`、`flv`、`mp4`、`mov`、`wmv`、`wma`、`webm`、`3gp`、`ogg`、`mts`
最大上传大小为 2 GB。最大上传时长为 4 小时。
## 支持的语言
`zh-CN` `zh-TW` `zh-HK` `en-US` `ja-JP` `ko-KR` `vi-VN` `th-TH` `hi-IN` `id-ID` `jv-ID` `ms-MY` `fil-PH` `ne-NP` `pt-PT` `es-ES` `fr-FR` `de-DE` `it-IT` `nl-NL` `ru-RU` `uk-UA` `pl-PL` `cs-CZ` `sk-SK` `sl-SI` `hr-HR` `sr-RS` `bg-BG` `ro-RO` `hu-HU` `lt-LT` `lv-LV` `da-DK` `nb-NO` `sv-SE` `fi-FI` `is-IS` `tr-TR` `ar-AE` `ar-EG` `fa-IR` `he-IL` `hy-AM` `az-AZ` `ka-GE` `el-GR` `gu-IN` `kn-IN` `ta-IN` `te-IN` `ur-IN` `bn-IN` `km-KH` `lo-LA` `si-LK` `sw-KE` `zu-ZA` `af-ZA` `am-ET` `eu-ES` `ca-ES` `gl-ES` `su-ID`
默认语言为 `ja-JP`。
## 示例提示
- "授权 Notta。"
- "使用 Notta 转录 `/Users/me/Documents/meeting.mp4`。"
- "检查记录 `12345` 的 Notta 状态。"
- "显示记录 `12345` 的转录。"
- "在我的 Notta 记录中搜索 `quarterly review`。"
- "列出我的 Notta 记录。"
## 手动 MCP 配置
在没有 MCPB 的情况下进行本地开发，构建服务器并将以下内容添加到 Claude Desktop 的 MCP 配置中：
```json
{
"mcpServers": {
"notta": {
"command": "node",
"args": [
"/absolute/path/to/notta_mcp/dist/notta-mcp.js",
"/absolute/path/to/allowed/media/folder"
]
}
}
}
```
至少需要一个允许的文件夹。服务器默认不允许 Desktop、Documents、Downloads 或其他本地文件夹。您可以将多个允许的文件夹作为附加参数传递。
## 隐私
此扩展通过 Notta 服务处理数据。当您使用 `transcribe` 时，扩展从允许的文件夹中读取选定的本地媒体文件，强制执行 2 GB 和 4 小时客户端上传限制，使用 Notta 提供的 S3 上传凭证上传，并创建 Notta 转录记录。记录列表、搜索、状态和查看工具使用您的本地 Notta 凭证调用 Notta 的公共 API。
Notta 隐私政策：https://www.notta.ai/en/privacy
## 版本说明
请参阅 `docs/RELEASE.md` 获取发布检查清单和安全控制。
