Claude的Zotero MCP搜索技能
全面的， 情境感知的 这项技能能够通过Zotero的MCP（模型上下文协议）服务器，实现对您的Zotero库进行高级、多策略的搜索。 设计为输出为纯Markdown格式的提纲，适合粘贴到Logseq中。 同时，还提供中英文标题和摘要的并排翻译功能，以优化Logseq中的英文搜索体验。在两者（中英文）中均能智能工作 Claude Desktop（可译为“Claude桌面版”或保持原名“Claude Desktop”，具体取决于上下文和品牌命名习惯） 并且 克劳德·科德。
这是什么
这是一个 通用的克劳德技能 这教Claude如何智能且全面地搜索你的Zotero参考文献库，并适应环境：
- 在克劳德代码中： 利用自主代理进行全面的多步搜索
- 在Claude Desktop中： 使用安全的批处理搜索，具备对话崩溃保护功能
- 对于纯Markdown大纲格式： 适合粘贴到Logseq中，带有中英对照的并排翻译
克劳德（Claude）学会的不是简单的单次搜索，而是：
- 使用 语义/人工智能驱动的搜索 寻找概念相关的论文
- 尝试 多个搜索角度 使用不同的措辞和同义词
- 结合搜索方法 （语义+关键词+标签+全文+注释）
- 迭代优化 基于结果的搜索
- 提出澄清性问题 当你的查询存在歧义时
- 调整策略 基于环境（代码中的代理，桌面端的批处理）
- 格式化为纯Markdown大纲 具有适合Logseq的结构和翻译
为何这项技能存在
问题
Zotero MCP服务器提供了强大的语义搜索功能，但要有效利用它，需要：
- 理解多种搜索策略（语义搜索、关键词搜索与基于标签的搜索）
- 知道何时使用每种搜索方法
- 尝试多种变化和措辞
- 在元数据、全文、笔记和注释中进行搜索
- Claude Desktop： 避免会导致对话崩溃的响应限制
- 克劳德密码： 利用代理进行自主综合搜索
没有指导的话，克劳德可能会：
- 只使用一种搜索方法，遗漏了相关论文
- 尝试仅使用一个搜索词并返回不完整的结果
- 在桌面中： 一次性请求过多结果（导致崩溃）
- 在代码中： 不使用代理进行复杂的多步骤搜索
- 不探索其他搜索角度
解决方案
这项技能为克劳德提供了：
- 环境检测 - 自动检测Claude Code与Claude Desktop
- 强制性的多角度搜索策略 （至少3种语义变化+3种关键词变化）
- 安全配料指南 适用于桌面版（每次搜索限制为10个，以防止程序崩溃）
- 基于代理的模式 对于代码（全面自主搜索）
- 全面搜索模式 结合多种方法
- 迭代优化工作流程 以提高结果
- 纯Markdown大纲格式 适合Logseq使用，支持中英文翻译
特点/功能
核心能力
- 情境感知操作： 检测环境并调整搜索策略
- 克劳德密码： 启动自主代理进行多步骤综合搜索 - Claude Desktop： 使用带崩溃保护的安全批量搜索
- 语义优先发现 利用人工智能进行概念搜索以查找相关工作
- 多策略搜索： 结合语义、关键词、标签以及全文检索方法
- 迭代细化： 分析初步结果并优化搜索策略
- 安全优先设计： 内置防护机制以防止Claude桌面版崩溃漏洞
- 全面覆盖： 搜索元数据、全文PDF、注释和笔记
- Logseq 集成： 为Logseq生成带有适当大纲层级的书目格式
- 翻译支持： 处理中英文双语内容
教授的搜索方法
- 语义搜索 - 使用AI嵌入表示的概念相似性
- 关键词搜索 - 带有变体的传统文本匹配
- 高级搜索 - 多标准过滤（作者 + 关键词 + 年份）
- 标签搜索 - 利用你现有的Zotero标签
- 全文搜索 - 在PDF内容中搜索
- 注释搜索 - 查找你的高亮内容和笔记
- 收藏夹搜索 - 浏览你的Zotero收藏集
环境特定特征
克劳德·科德
- 基于代理的搜索： 自主多步骤搜索执行
- 无限制限制： 可以安全地检索到全面的结果
- 并行搜索： 同时执行多种搜索策略
- 智能合成： 代理对结果进行去重和排序
Claude Desktop（可译为“Claude桌面版”或“Claude桌面应用”，具体根据上下文选择更贴切的表述）
- 安全分批： 每次搜索限制为10条，以防止程序崩溃
- 迭代展示： 逐步显示结果并等待用户确认
- 多角度覆盖： 多次小规模搜索，而非一次大规模搜索
- 碰撞保护： 内置防止对话删除的安全保障
输出格式化功能
- 纯Markdown大纲： 嵌套列表（不使用Markdown标题），适合粘贴到Logseq中
- 简洁引用： 作者姓名，年份。标题格式
- 无粗体样式： 全文使用纯文本
- 中英支持： 并列标题和摘要，提升英文搜索效果
- 自动翻译： 中文内容的英文翻译
- Zotero 链接： 每个项目的可点击zotero:// URL
- 主题组织： 按类别分组（无摘要部分）
安装
先决条件
- Zotero 桌面版 参考您的资料库
- Zotero MCP 服务器 安装并配置
- 仓库地址：https://github.com/54yyyu/zotero-mcp - 按照他们的安装说明进行操作
- Claude Desktop（可译为“Claude桌面版”或保持原样，具体取决于语境和是否需要意译） 和/或 克劳德·科德 带有MCP支持
- 在您的Claude MCP设置中配置的Zotero MCP服务器
安装此技能
对于Claude Desktop
- 下载该 最新发布 压缩文件
- 打开Claude桌面版
- 进入设置 → 技能
- 点击“导入技能”并选择已下载的zip文件
为克劳德·科德（Claude Code）
- 克隆或下载此仓库
- 将技能文件夹复制到
~/.claude/skills/zotero-mcp/ - 重启Claude代码或重新加载技能
手动安装
- 克隆或下载此存储库：
git clone https://github.com/kerim/zotero-mcp-skill.git- 复制
SKILL.md将文件放到你的Claude技能目录中 - 重启Claude或重新加载技能
使用
当克劳德使用这项技能时
当你需要时，克劳德会自动激活这项技能：
- 在你的Zotero库中搜索论文或参考文献
- 探索你收藏中的一个研究课题
- 查找与某个概念或主题相关的作品
- 查找特定的作者或论文
- 搜索你的批注和笔记
- 为Logseq生成格式化的参考文献列表
示例查询
概念性发现：
"Find papers about embodied cognition"- 克劳德密码： 启动代理 → 全面多策略搜索 → 精选结果
- Claude Desktop（桌面版）： 多个语义/关键词/标签搜索（每个限制为10个）→ 组合结果
作者搜索：
"What do I have by Susan Carey?"- 克劳德·科德（Claude Code，此名为音译，实际翻译可能因具体语境而异，此处为一种可能的译法） 代理搜索作者 + 引用 + 概念
- Claude Desktop（桌面版） 按作者+笔记+语义概念进行批量搜索
复杂话题：
"Research about skill transfer in mathematical reasoning"- 克劳德密码： 代理交叉参考多个概念 → 主题综合
- Claude Desktop（桌面版） 结合语义/关键词搜索 → 手动综合
文献生成：
"Create a Logseq bibliography for all papers on Indigenous language policy"→ 克劳德进行全面搜索 → 提取元数据 → 使用以下格式呈现：
- Logseq 的大纲层级结构（无标题）
- 简明引用格式（作者，年份。标题）
- 中英文双语支持
- 没有粗体样式
- Zotero链接
你会看到的搜索模式
克劳德·科德
- 分析查询 → 检测搜索类型
- 启动代理 → 自主综合搜索
- 代理执行 → 并行采用多种策略
- 代理综合（或“代理合成”，具体取决于上下文） → 去重和优先级排序
- 呈现研究结果 → 提供带有上下文的精选结果
Claude Desktop（克劳德桌面版）
- 分析查询 → 确定方法
- 执行批量搜索 → 进行5-10次搜索，每次搜索限制为10条结果
- 合并结果 合并并去重
- 如有需要，请进行润色 针对不佳结果的替代方案
- 展示研究结果 → 带有搜索路径解释的结果
搜索哲学
这项技能强制实施了一种 “全面搜索，而非狭隘搜索” 哲学：
核心原则
- 永远不要满足于一次搜索 - 总是尝试多个角度
- 永远不要使用单一的搜索词 - 总是尝试不同的变体和同义词
- 始终结合使用多种方法 - 语义 + 关键词 + 标签 + 全文
- 总是先检查标签 - 发现用户的标签使用习惯
- 不断迭代优化 - 分析结果并调整策略
- 如有不清楚之处，请务必询问 - 对模糊查询进行澄清提问
- 适应环境 - 在代码中使用代理，桌面端进行批处理
最低搜索要求
对于任何用户查询，Claude至少会尝试：
- 3种语义搜索变体（不同的表述方式）
- 3个关键词变体（同义词、相关术语）
- 1个标签搜索（在检查可用标签后）
- 1次全文/注释搜索（如适用）
配置
定制化
你可以通过编辑来定制这个技能 SKILL.md:
- 修改默认搜索限制（Claude Desktop：当前限制=10）
- 添加领域特定的搜索模式
- 调整搜索变体要求
- 添加自定义演示偏好设置
- 自定义Markdown大纲格式化规则
- 调整代理提示（仅限Claude代码）
搜索数据库
该技能将在需要时使用以下方法检查并更新您的Zotero语义搜索数据库：
zotero_get_search_database_status- 检查数据库状态zotero_update_search_database- 更新至最新项目
技术细节
使用的MCP工具
这项技能教会克劳德如何使用这些Zotero MCP服务器工具：
| 工具 | 用途 | 桌面限制 | 代码（代理） |
|---|---|---|---|
zotero_semantic_search | 基于AI的概念搜索 | 10 | 无限制 |
zotero_search_items | 关键词匹配 | 10 | 无限制 |
zotero_advanced_search | 多标准过滤 | 10 | 无限制 |
zotero_get_tags | 查找可用标签 | - | - |
zotero_search_by_tag | 基于标签的过滤 | 10 | 无限制 |
zotero_search_notes | 搜索注释/笔记 | 10 | 无限制 |
zotero_get_annotations | 获取亮点 | 10 | 无限制 |
zotero_get_item_fulltext | 访问全文内容 | - | - |
zotero_get_item_metadata | 获取项目元数据 | - | - |
zotero_get_collections | 列出集合 | - | - |
zotero_get_recent | 最新添加 | 10 | 无限制 |
安全机制
Claude Desktop（可译为“Claude桌面版”或根据上下文简化为“Claude桌面”）
- 硬性限制默认值 - 所有搜索默认使用 limit=10
- 批量迭代 - 进行多次小范围搜索，而非一次大规模搜索
- 交互式回退 - 渐进式结果展示
- 防撞（或防事故） - 单次调用时绝不超过限制=20
克劳德·科德
- 代理沙盒化 - 代理独立执行搜索
- 并行执行 - 同时进行多次搜索
- 智能合成 - 代理去重并设定优先级
- 无对话风险 - 代理不会导致用户界面崩溃
故障排除
“未找到结果”
克劳德将会：
- 尝试使用更广泛的搜索词
- 使用更通用的概念
- 移除过滤器
- 搜索相关领域/学科
- 提出澄清性问题
“搜索数据库已过时”
克劳德会建议：
zotero_update_search_database“结果过多/过少”
克劳德将自动：
- 太多了： 添加过滤器（标签、日期范围、集合）
- 太少： 扩大搜索范围，尝试同义词，搜索其他角度
“Claude Desktop 在搜索过程中崩溃”
如果您遇到对话被删除的情况：
- 该技能默认设置限制=10，以防止这种情况发生
- 确保您使用的是此技能的最新版本
- 向此仓库和Zotero MCP服务器报告持续存在的问题
贡献；做出贡献
欢迎贡献！以提升这项技能：
- 克隆这个仓库
- 对（相关内容）进行修改
SKILL.md - 使用Claude Desktop和Claude Code进行测试
- 提交拉取请求
贡献思路
- 特定领域的搜索模式（医学、法律等）
- 额外的搜索失败恢复策略
- 与其他Zotero MCP功能的集成
- 结果展示模板
- 针对特定语言的搜索变体
- 额外的Markdown大纲格式化样式
- 更多代理任务模式
相关项目
- Zotero MCP 服务器： https://github.com/54yyyu/zotero-mcp 翻译成中文可以是：“https://github.com/54yyyu/zotero-mcp（GitHub上的Zotero MCP项目）”。不过，通常在中文语境下，我们可能会直接使用网址，或者简单地提及这是一个GitHub上的项目链接，具体翻译取决于上下文和使用场景。如果要强调这是一个GitHub上的项目，可以翻译为：“这是GitHub上的一个项目链接：https://github.com/54yyyu/zotero-mcp，名为Zotero MCP”
- 模型上下文协议： https://modelcontextprotocol.io/（该网址可直接翻译为“模型上下文协议官方网站”，但实际翻译时通常保留原网址不变，仅在需要解释性说明时提供相应翻译）
- Claude Desktop（桌面版）： https://claude.ai/download（该网址可翻译为“https://claude.ai/下载”，但通常网址本身不直接翻译，保持原样即可）
- 克劳德代码： https://docs.claude.com/claude-code 翻译为中文是：“https://docs.claude.com/claude-code（或可意译为：科拉德文档网站上的科拉德代码部分）”。不过，通常在实际应用中，网址的翻译并不需要逐字翻译，而是直接保留原样，因为网址是全球通用的，不需要翻译。所以，更常见的表达方式就是直接写出原网址：“https://docs.claude.com/claude-code”。如果非要给出一个中文解释性说明，可以是：“这是科拉德（Claude）文档网站上的一个代码相关部分的网址”
许可证
MIT 许可证 - 请参阅 许可证 文件详情请见附件
致谢
- 为……而建造 Zotero MCP 服务器 由@54yyyu
- 专为Claude Desktop和Claude Code开发
- 由Claude嵌入模型驱动的语义搜索
支持
- 问题：
- 讨论：
- Zotero MCP 服务器问题： https://github.com/54yyyu/zotero-mcp/issues 的中文翻译为：“GitHub 上 54yyyu 的 Zotero-MCP 项目的问题页面”
______________________________________________________________________
专为希望在其Zotero库中进行全面、智能搜索的研究人员设计——无论是在Claude Desktop还是Claude Code中。