Agent 与 MCP 工具
Scholardo 为每个打开的项目起一个本地 MCP server。任何兼容 MCP 的 agent 接上之后，就能检索你的文库、读取标注、管理待办、下载论文——不用离开终端。
支持的 Agent
| Agent | 说明 |
|---|---|
| Claude Code | 推荐，一等公民支持 |
| Codex CLI | 完整支持 |
| pi | 完整支持，原生 MCP 桥接 |
| DeepSeek / Kimi / GLM 等 | 通过 Claude Code 载体接入 |
| 任意 MCP 兼容 agent | 手动配置 |
各家 CLI 的取舍见 我该选哪个 AI？。
连接
从 Scholardo 右栏启动的 agent 自动接上当前项目的 MCP server，不需要任何配置。这是在 Scholardo 里用 agent 而不是在外面单独开终端的主要理由之一。
每个项目有自己独立的 MCP server 和 socket，由应用管理生命周期——你切项目，agent 看到的就是新项目的内容。
验证连接：
scholardo-mcp list会列出当前项目可用的全部工具。看某个工具的完整参数：
scholardo-mcp describe search工具命名
Agent 侧看到的工具名带 MCP 命名空间前缀：mcp__scholardo__search。下面列出的是去掉前缀后的名字，也就是你在 scholardo-mcp describe 里用的名字。
可用工具
检索与取回
| 工具 | 作用 |
|---|---|
search | 全库检索（词法 / 语义 / 混合），见 语义检索 |
get_item | 按 ID 取回单条内容 |
batch_get_items | 批量取回 |
list_sources | 列出当前项目的资料 |
list_refs | 列出参考文献条目 |
list_notes | 列出笔记 |
标注（只读）
| 工具 | 作用 |
|---|---|
list_annotations | 列出某文档的全部标注 |
get_annotation | 按 ID 取一条 |
search_annotations | 按文本或标签搜索 |
标注对 agent 只读
没有写入工具，这是刻意的设计。Agent 能读你的所有划线来做总结和对比，但不能创建或修改——标记这件事保留在你手里。详见 标注。
笔记与记忆
| 工具 | 作用 |
|---|---|
create_note / update_note | 创建 / 更新笔记 |
save_memory / read_memory / update_memory / list_memory | 读写 agent 的长期记忆条目 |
待办
| 工具 | 作用 |
|---|---|
list_todos | 列出待办 |
create_todo | 新建 |
toggle_todo | 切换完成状态 |
set_reminder | 设置提醒 |
文献发现与获取
| 工具 | 作用 |
|---|---|
search_papers | 综合检索论文元数据 |
search_openalex | 检索 OpenAlex |
lookup_unpaywall | 查开放获取全文 |
download_pdf | 下载全文进 Docs |
pairing_audit | 检查 Docs 与 Refs 的配对缺口 |
queue_add | 把文献加入阅读队列 |
订阅源
add_feed · remove_feed · refresh_feed · set_feed_filter
详见 订阅源与摘要。
当前状态（「用户在看什么」）
| 工具 | 作用 |
|---|---|
active_context | 当前活跃的项目 / 文件 / 标签页 |
preview_text | 当前预览窗里的文本 |
web_page_context | 内置浏览器当前页面内容（需你显式共享） |
active_role | 当前生效的 agent 角色 |
context_status | 上下文状态 |
其他
| 工具 | 作用 |
|---|---|
get_tags / set_tags | 读写文件的 Finder 标签 |
get_writing_context / set_writing_context | 读写写作意图 |
get_rules | 读取当前生效的 agent 规则 |
get_settings | 读取相关设置 |
scholardo_list_agent_assets | 列出可用的技能 / 子智能体 / 工作流 |
scholardo_slide_check | 检查幻灯片内容是否溢出页面 |
ping | 连通性检查 |
为什么有两个长名字
绝大多数工具用短名（MCP 已经通过 server 名做了命名空间隔离，再带 scholardo_ 前缀是冗余）。scholardo_list_agent_assets 和 scholardo_slide_check 尚未纳入这轮改名，仍是长名。
实时资源
除工具外，Scholardo 还暴露 MCP 资源——支持资源协议的客户端（如 Claude Code）可以直接把它们挂进上下文，不占用工具调用次数：
| 资源 | 内容 |
|---|---|
scholardo://active/context | 当前活跃的项目与文件 |
scholardo://active/preview-text | 当前预览窗的文本 |
scholardo://active/web-page-context | 内置浏览器当前页面 |
这意味着你说「总结这几篇并找相关工作」时，agent 知道「这几篇」指的是什么。
从命令行调用
scholardo-mcp 也可以直接当 CLI 用，让不支持原生 MCP 的工具间接接入：
scholardo-mcp call search '{"query": "固态电解质界面阻抗"}'其他子命令：list（列工具）· describe <tool>（看参数）· instructions（看使用说明）
工具太多怎么办
Scholardo 会根据不同 agent 的能力调整工具暴露策略——上下文窗口紧张的模型按需加载工具定义，宽裕的直接全量提供。你不需要手动配置这个。