Agent 与 MCP 工具

Scholardo 提供本地 MCP server，任何兼容 agent 均可接入。Agent 可以检索文献库、读取标注、取回文档、引用参考文献、管理待办事项——无需离开终端。

支持的 Agent

Agent	说明
Claude Code	推荐，原生一等公民支持
Codex CLI	完整支持
任意 MCP 兼容 agent	手动配置 server URL 即可

连接 Claude Code

安装 Claude Code 后，Scholardo 会自动注册 MCP server。

打开 Scholardo → 设置 → Agent。
确认 MCP Server 已启用。
Server socket 路径显示在此：~/.scholardo/mcp.sock。
Claude Code 通过本地 MCP 发现协议自动接入。

在终端运行以下命令验证：

sh

scholardo-mcp list

正常输出会列出所有可用工具。

可用 MCP 工具（40+）

检索与取回

scholardo.search — 全库混合词法 + 语义检索
scholardo.retrieve — 按 ID 取回文档全文
scholardo.list_sources — 列出当前项目所有文档

标注

scholardo.annotations.list — 列出文档的所有标注
scholardo.annotations.get — 按 ID 获取具体标注
scholardo.annotations.search — 按文本或标签搜索标注

引用

scholardo.cite — 按指定 CSL 样式渲染引用
scholardo.bibliography — 生成一组文档 ID 的参考文献列表

会话与笔记

scholardo.sessions.list — 列出历史研究会话
scholardo.notes.list — 列出当前项目笔记
scholardo.notes.create — 创建笔记（agent 生成内容）

待办事项

scholardo.todos.list — 列出待办事项
scholardo.todos.create — 创建待办事项

实时资源

除工具外，Scholardo 还向 agent 暴露可实时读取的 MCP 资源：

scholardo://context/terminal — 当前终端输出
scholardo://context/browser — 内置浏览器当前页面
scholardo://context/preview — 当前正在预览的文档

这意味着「总结这几篇并找相关工作」之后，agent 能看到你正在看什么。

TIP

标注写入对 agent 只读。Agent 可以读取所有标注，但无法创建或修改——你始终掌控自己的标记。