星战科技xingzhan.cloud
返回市场
Zotero-MCP-技能服务器

Zotero-MCP-技能服务器

作者：kerim2 星标更新：2025-10-25
安装使用来源：spider==github.com

项目介绍

Zotero MCP 搜索技能用于 Claude

一个全面且上下文感知的技能，通过Zotero MCP（模型上下文协议）服务器实现对您的Zotero库进行高级多策略搜索。设计为以纯Markdown格式大纲输出，适合粘贴到Logseq中。同时提供中文标题和摘要的并排翻译，以提高在Logseq中的英文搜索效果。该技能在Claude Desktop和Claude Code中都能智能地工作。

这是什么

这是一个通用Claude技能，教会Claude如何智能且全面地搜索您的Zotero参考库，并适应环境：

  • 在Claude Code中： 使用自主代理进行综合多步骤搜索
  • 在Claude Desktop中： 使用安全批量搜索并带有对话崩溃保护
  • 对于纯Markdown大纲格式： 适合粘贴到Logseq中，并带有中文-英文翻译

Claude学习的不仅仅是简单的单次搜索，而是：

  • 使用语义/人工智能驱动的搜索来查找概念相关的论文
  • 尝试多种搜索角度，包括不同的措辞和同义词
  • 结合搜索方法（语义+关键词+标签+全文+注释）
  • 根据结果迭代优化搜索
  • 当查询模糊时提出澄清问题
  • 根据环境调整策略（在Code中使用代理，在Desktop中使用批量处理）
  • 格式化为纯Markdown大纲，具有适当的结构和Logseq所需的翻译

为什么存在这个技能

问题

Zotero MCP服务器提供了强大的语义搜索能力，但要有效使用它需要：

  • 理解多种搜索策略（语义与关键词与基于标签）
  • 知道何时使用每种搜索方法
  • 尝试多种变化和措辞
  • 在元数据、全文、笔记和注释之间搜索
  • 在Claude Desktop中： 避免响应限制导致对话崩溃
  • 在Claude Code中： 利用代理进行自主全面搜索

如果没有指导，Claude可能会：

  • 只使用一种搜索方法而错过相关论文
  • 只尝试一种搜索短语并返回不完整的结果
  • 在Desktop中： 一次性请求过多结果（导致崩溃）
  • 在Code中： 不利用代理进行复杂的多步搜索
  • 不探索替代搜索角度

解决方案

此技能为Claude提供：

  • 环境检测 - 自动检测Claude Code或Claude Desktop
  • 强制多角度搜索策略（至少3种语义+3种关键词变化）
  • 安全批量指南针对Desktop（每次搜索限制=10以防止崩溃）
  • 基于代理的模式针对Code（全面自主搜索）
  • 全面搜索模式结合多种方法
  • 迭代优化工作流以改进结果
  • 纯Markdown大纲格式适合Logseq，并支持中文/英文翻译

功能

核心能力

  • 上下文感知操作：检测环境并调整搜索策略
    • 在Claude Code中： 启动自主代理进行多步骤全面搜索
    • 在Claude Desktop中： 使用带有崩溃保护的安全批量搜索
  • 语义优先发现：AI驱动的概念搜索以找到相关工作
  • 多策略搜索：结合语义、关键词、基于标签和全文方法
  • 迭代优化：分析初始结果并优化搜索策略
  • 安全第一设计：内置防止Claude Desktop崩溃的保护措施
  • 全面覆盖：搜索元数据、全文PDF、注释和笔记
  • Logseq集成：格式化文献记录以适合Logseq，并具有适当的大纲层次结构
  • 翻译支持：处理中文-英文双语内容

教授的搜索方法

  1. 语义搜索 - 使用AI嵌入的概念相似性
  2. 关键词搜索 - 传统文本匹配及其变化
  3. 高级搜索 - 多条件过滤（作者+关键词+年份）
  4. 标签搜索 - 利用您现有的Zotero标签
  5. 全文搜索 - 在PDF内容中搜索
  6. 注释搜索 - 查找您的高亮和笔记
  7. 集合搜索 - 导航您的Zotero集合

环境特定功能

Claude Code

  • 基于代理的搜索：自主多步搜索执行
  • 无限制约束：可以安全地检索全面结果
  • 并行搜索：同时执行多种搜索策略
  • 智能合成：代理去重并优先级排序结果

Claude Desktop

  • 安全批量：每次搜索限制=10以防止崩溃
  • 迭代展示：逐步显示结果并获得用户确认
  • 多角度覆盖：多个小规模搜索而非大规模搜索
  • 崩溃保护：内置防止对话删除的保护措施

输出格式化功能

  • 纯Markdown大纲：嵌套项目符号（无Markdown标题），适合粘贴到Logseq
  • 紧凑引用：作者（们），年份. 标题格式
  • 无粗体样式：全文均为纯文本
  • 中文-英文支持：并排标题和摘要以提高英文搜索效果
  • 自动翻译：中文内容的英文翻译
  • Zotero链接：每个项目的可点击zotero://链接
  • 主题组织：按类别分组（无总结部分）

安装

先决条件

  1. Zotero桌面版，包含您的参考库
  2. 已安装并配置的Zotero MCP服务器
  3. 支持MCP的Claude Desktop和/或Claude Code
  4. 在您的Claude MCP设置中配置Zotero MCP服务器

安装此技能

对于Claude Desktop

  1. 下载最新发布的zip文件
  2. 打开Claude Desktop
  3. 前往设置 → 技能
  4. 点击“导入技能”并选择下载的zip文件

对于Claude Code

  1. 克隆或下载此仓库
  2. 将技能文件夹复制到~/.claude/skills/zotero-mcp/
  3. 重启Claude Code或重新加载技能

手动安装

  1. 克隆或下载此仓库： 
    git clone https://github.com/kerim/zotero-mcp-skill.git
  2. 将SKILL.md文件复制到您的Claude技能目录
  3. 重启Claude或重新加载技能

使用

当Claude使用此技能时

当您需要以下操作时，Claude会自动激活此技能：

  • 在您的Zotero库中搜索论文或参考资料
  • 探索您收藏中的研究主题
  • 查找关于某个概念或主题的相关工作
  • 查找特定作者或论文
  • 在您的注释和笔记中搜索
  • 为Logseq生成格式化的文献记录

示例查询

概念发现：

"查找关于具身认知的论文"
  • 在Claude Code中： 启动代理 → 综合多策略搜索 → 筛选结果
  • 在Claude Desktop中： 多个语义/关键词/标签搜索（每次搜索限制=10）→ 结果合并

作者搜索：

"我有哪些Susan Carey的作品？"
  • 在Claude Code中： 代理搜索作者 + 引用 + 概念
  • 在Claude Desktop中： 批量搜索作者 + 笔记 + 语义概念

复杂主题：

"关于数学推理中的技能迁移的研究"
  • 在Claude Code中： 代理交叉引用多个概念 → 主题综合
  • 在Claude Desktop中： 组合语义/关键词搜索 → 手动综合

文献记录生成：

"为所有关于土著语言政策的论文创建Logseq文献记录"

→ Claude进行全面搜索 → 获取元数据 → 格式化为：

  • Logseq大纲层次结构（无标题）
  • 紧凑引用（作者，年份. 标题）
  • 中文/英文双语支持
  • 无粗体样式
  • Zotero链接

您将看到的搜索模式

Claude Code

  1. 分析查询 → 检测搜索类型
  2. 启动代理 → 自主全面搜索
  3. 代理执行 → 并行执行多种策略
  4. 代理合成 → 去重并优先级排序
  5. 呈现发现 → 带有上下文的筛选结果

Claude Desktop

  1. 分析查询 → 确定方法
  2. 执行批量搜索 → 5-10次搜索，每次搜索限制=10
  3. 组合结果 → 合并并去重
  4. 如有必要则优化 → 对于差的结果尝试其他角度
  5. 呈现发现 → 带有搜索路径解释的结果

搜索哲学

此技能遵循**“全面搜索，而不是狭窄搜索”**的哲学：

核心原则

  • 永远不要满足于一次搜索 - 总是尝试多种角度
  • 永远不要只使用一个搜索词 - 总是尝试变化和同义词
  • 总是结合方法 - 语义 + 关键词 + 标签 + 全文
  • 总是先检查标签 - 发现用户的标签习惯
  • 总是迭代优化 - 分析结果并调整策略
  • 总是询问不清楚的地方 - 对模糊查询提出澄清问题
  • 适应环境 - 在Code中使用代理，在Desktop中使用批量处理

最低搜索要求

对于任何用户查询，Claude至少会尝试：

  • 3种语义搜索变化（不同措辞）
  • 3种关键词变化（同义词，相关术语）
  • 1种标签搜索（在检查可用标签后）
  • 1种全文/注释搜索（如果适用）

配置

自定义

您可以通过编辑SKILL.md来自定义此技能：

  • 修改默认搜索限制（Claude Desktop：目前限制=10）
  • 添加领域特定的搜索模式
  • 调整搜索变化要求
  • 添加自定义展示偏好
  • 自定义Markdown大纲格式规则
  • 调整代理提示（仅限Claude Code）

搜索数据库

当需要时，此技能会检查并更新您的Zotero语义搜索数据库：

  • zotero_get_search_database_status - 检查数据库状态
  • zotero_update_search_database - 使用最新条目更新

技术细节

使用的MCP工具

此技能教会Claude使用这些Zotero MCP服务器工具：

工具目的Desktop限制Code（代理）
zotero_semantic_searchAI驱动的概念搜索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

  1. 硬限制默认值 - 所有搜索默认使用限制=10
  2. 批量迭代 - 多个小规模搜索而非大规模搜索
  3. 交互式回退 - 逐步展示结果
  4. 防止崩溃 - 单次调用不超过限制=20

Claude Code

  1. 代理沙箱 - 代理独立运行搜索
  2. 并行执行 - 多个搜索同时进行
  3. 智能合成 - 代理去重并优先级排序
  4. 无对话风险 - 代理不会导致UI崩溃

故障排除

“未找到结果”

Claude会：

  • 尝试更广泛的搜索词
  • 使用更一般的概念
  • 移除过滤器
  • 搜索相关领域/学科
  • 提出澄清问题

“搜索数据库过时”

Claude会建议：

zotero_update_search_database

“结果过多/过少”

Claude会自动：

  • 结果过多： 添加过滤器（标签、日期范围、集合）
  • 结果过少： 扩大词汇，尝试同义词，搜索其他角度

“Claude Desktop搜索期间崩溃”

如果您遇到对话删除：

  • 此技能默认强制限制=10以防止这种情况
  • 确保您使用的是此技能的最新版本
  • 向此仓库和Zotero MCP服务器报告持续的问题

贡献

欢迎贡献！为了改进此技能：

  1. 分叉此仓库
  2. 修改SKILL.md
  3. 使用Claude Desktop和Claude Code测试
  4. 提交拉取请求

贡献想法

  • 领域特定的搜索模式（医学、法律等）
  • 额外的搜索失败恢复策略
  • 与其他Zotero MCP功能的集成
  • 结果展示模板
  • 语言特定的搜索变化
  • 额外的Markdown大纲格式风格
  • 更多的代理任务模式

相关项目

许可证

MIT许可证 - 详情见LICENSE文件

致谢

  • 由@54yyyu为Zotero MCP服务器构建
  • 为Claude Desktop和Claude Code开发
  • 语义搜索由Claude的嵌入模型驱动

支持

专为希望全面智能搜索其Zotero库的研究人员设计 - 无论是在Claude Desktop还是Claude Code中。