内容
# alt-festival-mcp
一个 [MCP](https://modelcontextprotocol.io) 服务器，允许 Claude（桌面版或代码版）实时读取 [Alt](https://alt.chat) 的笔记和转录记录，Alt 是一款实时会议/讲座转录应用程序。
为会议使用而构建：保持 Alt 记录讲座，并实时向 Claude 提问，Claude 每次只提取新转录的记录，而不是重新阅读整个转录记录。
## 工作原理
Alt 在您的机器上运行一个本地 HTTP API（`localhost`，令牌身份验证），其自己的应用程序内部使用。 这不是官方文档，不适用于第三方使用，因此将其视为非官方的，并可能因 Alt 更新而中断。 该服务器在请求时从 Alt 自己的本地配置文件（`~/Library/Application Support/alt/storage-httpServer.json` 在 macOS 上）读取端口/令牌，并通过 MCP 公开几个只读操作。 它不会在其他地方存储或传输令牌。
您的 Alt 数据不会离开您的机器 — 该服务器只与 `localhost` 通信。
## 工具
| 工具 | 描述 |
|---|---|
| `list_recent_notes` | 列出最近创建/更新的 Alt 笔记。通常最新的笔记是当前正在录制的笔记。 |
| `search_notes` | 按标题搜索笔记。 |
| `get_note_info` | 获取单个笔记的标题、日期和状态。 |
| `list_note_components` | 列出笔记的组成部分（转录记录、备忘录、摘要、录音、会议笔记等），无需获取其内容。 |
| `get_note_transcript` | 获取笔记的实时转录记录。传递 `sinceIndex`（上次调用的 `totalEntries` 值），仅获取新转录的记录 — 避免每次调用都重新发送整个增长的转录记录。 |
## 要求
- [Alt](https://alt.chat) 已安装并运行，其本地 HTTP 服务器已启用（这是默认设置）。
- macOS。目前配置路径已硬编码到 Alt 的 macOS 数据目录；Windows/Linux 路径尚未处理。
- Node.js 20+。
## 安装
```bash
git clone https://github.com/dkfmaekdnjfk/alt-festival-mcp.git
cd alt-festival-mcp
npm install
npm run build
```
## 在 Claude Code / Desktop 上注册
```bash
claude mcp add --scope user alt -- node /绝对路径/到/alt-festival-mcp/dist/index.js
```
重启 Claude Code/Desktop 以使其拾取新的服务器，然后在 Alt 中开始录制并向其提问。
## 示例用法
> "Alt에서 지금 녹음 중인 노트 열어서 지금까지 무슨 얘기했는지 알려줘"
> （打开 Alt 当前正在录制的笔记，并告诉我到目前为止说了什么）
Claude 将调用 `list_recent_notes` 以找到活动笔记，然后调用 `get_note_transcript` 以读取它 — 在同一对话的后续问题中，传递 `sinceIndex` 以便它只读取新的内容。
## 免责声明
该项目与 Alt 内部公开的本地 API 进行通信，该 API 恰好在您的机器上公开。 它与 Alt 无关或未得到 Alt 的认可。 它可能会在更改 API 形状的 Alt 更新后停止工作。
