内容
# Plaud MCP 服务器
将您的 [Plaud Note](https://www.plaud.ai) 记录直接连接到 Claude、Cursor 或任何兼容 MCP 的 AI 客户端。无需手动操作，搜索、检索和处理您的会议记录和 AI 摘要。
## 功能
该 MCP 服务器为您的 AI 助手提供直接访问您的 Plaud 记录的功能：
- **列出记录** — 查看所有记录，包含日期、时长和记录状态
- **获取记录文本** — 拉取任意记录的完整说话者-分段记录
- **获取 AI 摘要** — 检索 Plaud 的 AI 生成的会议摘要
- **搜索** — 按标题/关键词查找记录
- **获取最近记录** — 快速拉取最近的记录，包含完整的记录文本
## 设置（5 分钟）
### 1. 安装依赖
```bash
git clone https://github.com/YOUR_USERNAME/plaud-mcp.git
cd plaud-mcp
pip install -r requirements.txt
```
### 2. 获取您的 Plaud 认证令牌
Plaud 不提供公开的 API 密钥，因此您需要从网页应用中获取会话令牌：
1. 在 Chrome 中打开 [web.plaud.ai](https://web.plaud.ai)
2. 登录您的账户
3. 打开开发者工具：`Cmd+Option+J`（Mac）或 `Ctrl+Shift+J`（Windows）
4. 点击 **网络** 标签
5. 刷新页面
6. 点击任意请求到 `api.plaud.ai`
7. 在请求头中，找到 `Authorization: Bearer eyJ...`
8. 复制 `Bearer ` 之后的内容 — 那就是您的令牌
### 3. 配置您的令牌
```bash
cp .env.example .env
```
打开 `.env` 并粘贴您的令牌：
```
PLAUD_TOKEN=eyJhbGciOiJSUzI1NiIs...your_full_token_here
```
### 4. 连接到您的 AI 客户端
#### Claude 代码
```bash
claude mcp add plaud -- python /path/to/plaud-mcp/server.py
```
#### Claude 桌面版
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"plaud": {
"command": "python",
"args": ["/path/to/plaud-mcp/server.py"],
"env": {
"PLAUD_TOKEN": "your_token_here"
}
}
}
}
```
#### Cursor / Windsurf / 其他 MCP 客户端
遵循相同的模式 — 将 `server.py` 指向命令，并将您的令牌作为环境变量。
### 5. 测试
询问您的 AI： *"列出我的最近 Plaud 记录"* 或 *"我上次会议讨论了什么？"*
## 令牌刷新
Plaud 令牌会定期过期。当您遇到身份验证错误时，只需重复步骤 2 以获取新的令牌并更新您的 `.env` 文件。
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `plaud_verify_token` | 检查您的身份验证令牌是否有效 |
| `plaud_list_recordings` | 列出记录，支持分页 |
| `plaud_get_transcript` | 获取记录的完整记录文本 + AI 摘要 |
| `plaud_search_recordings` | 按标题关键词搜索记录 |
| `plaud_get_recent` | 获取最近的记录，包含完整的记录文本 |
## 隐私
- 该程序 **100% 在您的本地机器上运行**
- 您的 Plaud 令牌永远不会离开您的计算机
- 没有数据发送到任何第三方
- 只有您可以通过此服务器访问您的记录
## 许可证
MIT — 您可以随意使用。
