AI导哈

转录服务代理工具

通过Chrome DevTools协议代理Plaud Desktop应用的转录服务，实现无需提取令牌的API调用。

  • by davidlinjiahao
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 davidlinjiahao/plaud-mcp

使用说明

Plaud MCP服务器

通过运行的Plaud Desktop应用程序，通过CDP代理为Plaud转录本提供MCP服务器。

运作原理

Claude Code → MCP Server → CDP (WebSocket) → Plaud Desktop → Plaud API

MCP通过Chrome DevTools协议连接到正在运行的Plaud Desktop Electron应用程序：

  1. 发送 SIGUSR1 到Plaud Desktop进程以启用Node.js检查器（端口9229）
  2. 通过WebSocket连接到检查器
  3. 通过应用程序自己的身份验证执行API调用 $fetch 函数
  4. 通过MCP工具返回结果

没有令牌提取，没有cookie，没有API密钥。直接使用应用程序的实时身份验证会话。

先决条件

  1. 平板电脑 -已安装并登录
  2. Python 3.10+
  3. 紫外线 （推荐）

安装

# Install as a CLI tool (recommended)
uv tool install "plaud-mcp @ git+https://github.com/davidlinjiahao/plaud-mcp"

# Or install from local source
uv tool install --force "plaud-mcp @ ."

配置

添加 ~/.claude.json:

{
  "mcpServers": {
    "plaud": {
      "command": "${HOME}/.local/bin/plaud-mcp",
      "args": [],
      "env": {}
    }
  }
}

不需要API密钥或令牌。只需确保Plaud Desktop正在运行。

MCP工具

工具 说明
check_connection 验证Plaud桌面是否可用
get_file_count 记录总数
get_recent_files 最近N天的文件
get_files 带有可选日期过滤器的文件
get_file 特定文件的元数据
get_transcript 带有演讲者标签的完整成绩单
get_summary 人工智能生成的摘要
search_transcripts 按内容搜索成绩单

故障排除

“Plaud桌面未运行”

启动Plaud Desktop应用程序并登录。

“无法启用检查器”

SIGUSR1信号可能失败。确保Plaud Desktop是主要进程，而不是辅助进程。

搜索速度慢

search_transcripts 在客户端获取和搜索。减少 days 参数。

为什么选择CDP？

Plaud的API在Chromium网络堆栈级别验证身份验证-从LevelDB提取的令牌不适用于标准HTTP客户端（httpx、curl、curl_cffi和Chrome模拟都返回401）。CDP方法通过应用程序自己的身份验证上下文执行请求，完全绕过了这一点。

发展

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
ruff check src/ && pyright src/

相关 MCP