Claude的Zotero MCP搜索技能
这是什么
这是一个 通用的克劳德技能 这教Claude如何智能且全面地搜索你的Zotero参考文献库,并适应环境:
- 在克劳德代码中: 利用自主代理进行全面的多步搜索
- 在Claude Desktop中: 使用安全的批处理搜索,具备对话崩溃保护功能
克劳德(Claude)学会的不是简单的单次搜索,而是:
- 使用 语义/人工智能驱动的搜索 寻找概念相关的论文
- 尝试 多个搜索角度 使用不同的措辞和同义词
- 结合搜索方法 (语义+关键词+标签+全文+注释)
- 迭代优化 基于结果的搜索
- 提出澄清性问题 当你的查询存在歧义时
- 调整策略 基于环境(代码中的代理,桌面端的批处理)
为何这项技能存在
问题
Zotero MCP服务器提供了强大的语义搜索功能,但要有效利用它,需要:
- 理解多种搜索策略(语义搜索、关键词搜索与基于标签的搜索)
- 知道何时使用每种搜索方法
- 尝试多种变化和措辞
- 在元数据、全文、笔记和注释中进行搜索
- Claude Desktop: 避免会导致对话崩溃的响应限制
- 克劳德密码: 利用代理进行自主综合搜索
没有指导的话,克劳德可能会:
- 只使用一种搜索方法,遗漏了相关论文
- 尝试仅使用一个搜索词并返回不完整的结果
- 在桌面中: 一次性请求过多结果(导致崩溃)
- 在代码中: 不使用代理进行复杂的多步骤搜索
- 不探索其他搜索角度
解决方案
这项技能为克劳德提供了:
- 环境检测 - 自动检测Claude Code与Claude Desktop
- 强制性的多角度搜索策略 (至少3种语义变化+3种关键词变化)
- 安全配料指南 适用于桌面版(每次搜索限制为10个,以防止程序崩溃)
- 基于代理的模式 对于代码(全面自主搜索)
- 全面搜索模式 结合多种方法
- 迭代优化工作流程 以提高结果
特点/功能
核心能力
- 情境感知操作: 检测环境并调整搜索策略
- 克劳德密码: 启动自主代理进行多步骤综合搜索
- 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代码或重新加载技能
手动安装
- 克隆或下载此存储库:```bash
git clone https://github.com/kerim/zotero-mcp-skill.git
1. 复制 `SKILL.md` 将文件放到你的Claude技能目录中
1. 重启Claude或重新加载技能
## 使用
### 当克劳德使用这项技能时
当你需要时,克劳德会自动激活这项技能:
- 在你的Zotero库中搜索论文或参考文献
- 探索你收藏中的一个研究课题
- 查找与某个概念或主题相关的作品
- 查找特定的作者或论文
- 搜索你的批注和笔记
- 为Logseq生成格式化的参考文献列表
### 示例查询
**概念性发现:**```
"Find papers about embodied cognition"
- 克劳德密码: 启动代理 → 全面多策略搜索 → 精选结果
- Claude Desktop(桌面版): 多个语义/关键词/标签搜索(每个限制为10个)→ 组合结果
作者搜索:```
"What do I have by Susan Carey?"
- **Claude Desktop(桌面版)** 按作者+笔记+语义概念进行批量搜索
**复杂话题:**```
"Research about skill transfer in mathematical reasoning"
- 克劳德密码: 代理交叉参考多个概念 → 主题综合
- Claude Desktop(桌面版) 结合语义/关键词搜索 → 手动综合
文献生成:```
"Create a Logseq bibliography for all papers on Indigenous language policy"
→ 克劳德进行全面搜索 → 提取元数据 → 使用以下格式呈现:
- Logseq 的大纲层级结构(无标题)
- 简明引用格式(作者,年份。标题)
- 中英文双语支持
- 没有粗体样式
- Zotero链接
### 你会看到的搜索模式
#### 克劳德·科德
1. **分析查询** → 检测搜索类型
1. **启动代理** → 自主综合搜索
1. **代理执行** → 并行采用多种策略
1. **代理综合(或“代理合成”,具体取决于上下文)** → 去重和优先级排序
1. **呈现研究结果** → 提供带有上下文的精选结果
#### Claude Desktop(克劳德桌面版)
1. **分析查询** → 确定方法
1. **执行批量搜索** → 进行5-10次搜索,每次搜索限制为10条结果
1. **合并结果** 合并并去重
1. **如有需要,请进行润色** 针对不佳结果的替代方案
1. **展示研究结果** → 带有搜索路径解释的结果
## 搜索哲学
这项技能强制实施了一种 **“全面搜索,而非狭隘搜索”** 哲学:
### 核心原则
- **永远不要满足于一次搜索** - 总是尝试多个角度
- **永远不要使用单一的搜索词** - 总是尝试不同的变体和同义词
- **始终结合使用多种方法** - 语义 + 关键词 + 标签 + 全文
- **总是先检查标签** - 发现用户的标签使用习惯
- **不断迭代优化** - 分析结果并调整策略
- **如有不清楚之处,请务必询问** - 对模糊查询进行澄清提问
- **适应环境** - 在代码中使用代理,桌面端进行批处理
### 最低搜索要求
对于任何用户查询,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桌面”)
1. **硬性限制默认值** - 所有搜索默认使用 limit=10
1. **批量迭代** - 进行多次小范围搜索,而非一次大规模搜索
1. **交互式回退** - 渐进式结果展示
1. **防撞(或防事故)** - 单次调用时绝不超过限制=20
#### 克劳德·科德
1. **代理沙盒化** - 代理独立执行搜索
1. **并行执行** - 同时进行多次搜索
1. **智能合成** - 代理去重并设定优先级
1. **无对话风险** - 代理不会导致用户界面崩溃
## 故障排除
### “未找到结果”
克劳德将会:
- 尝试使用更广泛的搜索词
- 使用更通用的概念
- 移除过滤器
- 搜索相关领域/学科
- 提出澄清性问题
### “搜索数据库已过时”
克劳德会建议:```
zotero_update_search_database
“结果过多/过少”
克劳德将自动:
- 太多了: 添加过滤器(标签、日期范围、集合)
- 太少: 扩大搜索范围,尝试同义词,搜索其他角度
“Claude Desktop 在搜索过程中崩溃”
如果您遇到对话被删除的情况:
- 该技能默认设置限制=10,以防止这种情况发生
- 确保您使用的是此技能的最新版本
- 向此仓库和Zotero MCP服务器报告持续存在的问题
贡献;做出贡献
欢迎贡献!以提升这项技能:
- 克隆这个仓库
- 对(相关内容)进行修改
SKILL.md - 使用Claude Desktop和Claude Code进行测试
- 提交拉取请求
贡献思路
- 特定领域的搜索模式(医学、法律等)
- 额外的搜索失败恢复策略
- 与其他Zotero MCP功能的集成
- 结果展示模板
- 针对特定语言的搜索变体
- 额外的Markdown大纲格式化样式
- 更多代理任务模式
相关项目
许可证
MIT 许可证 - 请参阅 许可证 文件详情请见附件
致谢
- 为……而建造 Zotero MCP 服务器 由@54yyyu
- 专为Claude Desktop和Claude Code开发
- 由Claude嵌入模型驱动的语义搜索
支持
- 问题: GitHub Issues(GitHub问题)
- 讨论: GitHub 讨论区
专为希望在其Zotero库中进行全面、智能搜索的研究人员设计——无论是在Claude Desktop还是Claude Code中。
