PDF Triage

git clone https://github.com/vishalmeena2211/pdf-triage-mcp.git
cd pdf-triage-mcp
npm install
npm run build
node dist/index.js --root ~/Documents

然后，在下方任一配置中，用 "command": "node", "args": ["/absolute/path/to/dist/index.js", ...] 替换 npx 调用。

配置文件

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

验证： 完全退出并重新启动 Claude Desktop（不要只关闭窗口）。聊天输入框旁会出现一个工具图标 — 点击它并确认列表中有四个 pdf_* 工具。

日志：~/Library/Logs/Claude/mcp*.log（macOS）、%APPDATA%\Claude\logs\mcp*.log（Windows）。

文档

命令行 — 最简单的方式。 -- 分隔符是必需的；它之后的所有内容都是服务命令。

# Just you, this project (default)
claude mcp add pdf-triage -- npx -y pdf-triage-mcp --root /Users/me/Documents

# Just you, every project
claude mcp add --scope user pdf-triage -- npx -y pdf-triage-mcp --root /Users/me/Documents

# Shared with your team, writes .mcp.json to the repo
claude mcp add --scope project pdf-triage -- npx -y pdf-triage-mcp --root /Users/me/Documents

或者直接编辑项目根目录中的 .mcp.json：

{
  "mcpServers": {
    "pdf-triage": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

验证： claude mcp list → 查找 ✔ Connected。项目级服务首次使用时需要批准 — 在会话中运行 /mcp。

文档

配置文件： .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）。发生冲突时以项目配置为准。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

验证： Cursor 会热重载 — 无需重启。打开 Cursor 设置 → 工具与 MCP，查找 pdf-triage 旁的绿色圆点。

文档

配置文件： ~/.codeium/windsurf/mcp_config.json（macOS/Linux），%USERPROFILE%\.codeium\windsurf\mcp_config.json（Windows）。

首次启动时不会创建此文件 — 如果文件不存在，请自行创建。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

验证： Windsurf 会监视该文件，并在保存时热重载。下一次聊天会话中，工具会显示在 Cascade 中。

文档

键名是 servers，不是 mcpServers。 从 Claude Desktop 复制配置时，最常见的错误就是这一点。

配置文件： .vscode/mcp.json（工作区），或命令面板 → MCP: Open User Configuration（全局）。

{
  "servers": {
    "pdf-triage": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

命令行替代方式：

code --add-mcp '{"name":"pdf-triage","command":"npx","args":["-y","pdf-triage-mcp","--root","/Users/me/Documents"]}'

验证： MCP 工具只能在 Agent 模式下使用 — 在 Copilot Chat 中从 Ask/Edit 切换到 Agent，然后点击 配置工具并确认出现了 pdf_* 工具。首次添加文件后，请重启 VS Code。

文档

键名是 context_servers，不是 mcpServers， 而且 command 是嵌套对象，而非字符串。

配置文件： ~/.config/zed/settings.json（macOS/Linux），%APPDATA%\Zed\settings.json（Windows）。命令面板 → zed: open settings。

{
  "context_servers": {
    "pdf-triage": {
      "source": "custom",
      "command": {
        "path": "npx",
        "args": [
          "-y", "pdf-triage-mcp",
          "--root", "/Users/me/Documents"
        ],
        "env": {}
      }
    }
  }
}

如果你的 Zed 版本不接受这种格式，说明它早于嵌套格式 — 请尝试将 command、args 和 env 平铺到服务对象的顶层。

验证： Agent 面板（Cmd+Shift+A）→ 齿轮图标 → MCP Servers。绿色圆点表示已连接。

文档

配置文件 — 与 VS Code 自身的配置文件分开：

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ],
      "disabled": false,
      "autoApprove": ["pdf_classify", "pdf_search"]
    }
  }
}

autoApprove 会在无需确认提示的情况下运行所列的只读工具。

验证： 面板会自动刷新；服务旁边会显示绿色圆点。

文档

配置文件： ~/.continue/config.yaml（全局）或 .continue/config.yaml（项目）。当前使用 YAML；config.json 已弃用。

此处的 mcpServers 是一个列表，不是对象；YAML 必须使用空格，绝不能使用制表符。

mcpServers:
  - name: pdf-triage
    command: npx
    args:
      - -y
      - pdf-triage-mcp
      - --root
      - /Users/me/Documents

验证： 保存后会自动重新加载。将 Continue 切换到 Agent mode——其他模式下无法使用 MCP 工具。

文档

命令行：

gemini mcp add pdf-triage npx -y pdf-triage-mcp --root /Users/me/Documents

# global instead of project-scoped
gemini mcp add --scope user pdf-triage npx -y pdf-triage-mcp --root /Users/me/Documents

或者编辑 ~/.gemini/settings.json（全局）/ .gemini/settings.json（项目）：

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ],
      "timeout": 30000,
      "trust": false
    }
  }
}

验证： 在 gemini 会话中运行 /mcp，服务会显示为 CONNECTED，并列出其工具。也可以在 shell 中运行 gemini mcp list。

文档

配置文件： ~/.codex/config.toml（全局）或 .codex/config.toml（项目）。

使用 TOML，键名为 mcp_servers——采用 snake_case，绝不能写成 mcpServers。

[mcp_servers.pdf-triage]
command = "npx"
args = [
  "-y", "pdf-triage-mcp",
  "--root", "/Users/me/Documents"
]
startup_timeout_sec = 20
tool_timeout_sec = 60

验证： codex doctor --json 会验证配置语法。请注意，它只验证语法，不会确认服务是否实际启动。

已知的上游问题： 多个版本的 Codex CLI 存在一个错误：stdio 服务通过验证后仍会悄然启动失败，并在 TUI 中显示 Tools: none（#3441，#26810）。这是 Codex 运行时错误，不是配置错误。

文档

AI Assistant — 通过 IDE 配置，无需编辑文件：

1. Settings → Tools → AI Assistant → Model Context Protocol (MCP)
2. Add → 传输方式选择 STDIO
3. 粘贴：

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

4. OK → Apply

Junie 使用文件配置——~/.junie/mcp/mcp.json（全局）或 .junie/mcp/mcp.json（项目），JSON 结构相同。

验证： 查看 MCP 设置面板中的 Status 列；点击该列即可列出服务的工具。

文档

配置文件： ~/.lmstudio/mcp.json（macOS/Linux）、%USERPROFILE%\.lmstudio\mcp.json（Windows）。

通过应用操作更简单：右侧边栏 → Program 标签页 → Install → Edit mcp.json。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

验证： 保存后会自动重新加载；工具会显示在 Program 面板中。LM Studio 会在模型首次调用工具时显示确认对话框。

文档