Zotero Code Execution

MCP搜索检索

提供方 kerim

搜索检索 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

一个Python库,通过代码执行模式实现Zotero的安全、全面搜索,避免上下文溢出和崩溃。

一句话选型结论

按资料字段整理

Zotero Code Execution 属于搜索检索类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 54 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文献管理Python本地部署多策略搜索代码执行学术研究工具Python库

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zotero Code Execution当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方kerim上游标注的维护方 kerim
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.1 KB
来自项目仓库与上游目录的原文,未做删改

Zotero代码执行

> 使用代码执行模式的高效多策略Zotero搜索

Python库 Zotero MCP 实现 Anthropic的代码执行模式 以实现安全、全面的搜索,而不会出现上下文溢出或崩溃。

技能安装

克劳德代码

  1. 克隆或下载此存储库
  2. 复制 skill/ 文件夹到您的Claude Code技能目录:```bash
    cp -r skill ~/.claude/skills/zotero-mcp-code
1. 重启Claude Code加载技能

## 快速开始```python
import sys
sys.path.append('/path/to/zotero-code-execution')
import setup_paths
from zotero_lib import SearchOrchestrator, format_results

# Single comprehensive search - fetches 100+ items, returns top 20
orchestrator = SearchOrchestrator()
results = orchestrator.comprehensive_search("embodied cognition", max_results=20)
print(format_results(results))

就是这样! 这会自动:

  • ✅ 执行语义+关键字+标签搜索
  • ✅ 消除重复结果
  • ✅ 按相关性排名
  • ✅ 将大型数据集保存在代码中(无崩溃)

多词搜索

对于OR风格的搜索(例如,多种拼写或语言),分别搜索每个词并合并:```python

Search for "Atayal" OR "泰雅族"

all_results = {}

for term in ['Atayal', '泰雅族']:
results = orchestrator.comprehensive_search(term, max_results=50)
for item in results:
all_results[item.key] = item # Deduplicate by key

Re-rank combined results

ranked = orchestrator._rank_items(list(all_results.values()), 'Atayal 泰雅族')
print(format_results(ranked[:25]))


**为什么?** Zotero将多词查询视为AND条件。搜索“泰雅族泰雅族“查找与两个术语都匹配的项目,而不是任何一个术语。

## 为什么存在

### 问题

直接MCP工具调用有局限性:

- 🚫 **崩盘风险** 结果集较大(>15-20个项目)
- 🚫 **代币膨胀** -所有结果都加载到LLM上下文中
- 🚫 **手动编排** -多次搜索、手动重复数据删除
- 🚫 **没有排名** -结果未按相关性排序

### 解决方案

代码执行将大型数据集保存在执行环境中:

- ✅ **无碰撞** -只有经过筛选的结果才能返回上下文
- ✅ **代币高效** -处理100+个项目,返回前20个
- ✅ **自动编排** -一次通话中的多策略搜索
- ✅ **自动排名** -按相关性排序的结果

## 特性

### 多策略搜索

一个函数调用执行:

- 语义搜索(多种变体)
- 关键字搜索(多种模式)
- 基于标签的搜索
- 自动重复数据删除
- 相关性排名

### 安全大搜索```python
# ❌ Old way: Crash risk
results1 = zotero_semantic_search("query", limit=10)  # Limited to 10
results2 = zotero_search_items("query", limit=10)     # Another 10
# Manual deduplication, manual ranking...

# ✅ New way: Safe and comprehensive
orchestrator = SearchOrchestrator()
results = orchestrator.comprehensive_search("query", max_results=20)
# Fetches 100+, processes in code, returns top 20

高级过滤```python

Fetch broadly, filter in code

library = ZoteroLibrary()
items = library.search_items("machine learning", limit=100) # Safe!

Filter to recent journal articles

filtered = orchestrator.filter_by_criteria(
items,
item_types=["journalArticle"],
date_range=(2020, 2025)
)


## 安装

### 需求

- Python 3.8+
- Zotero MCP 通过pipx安装
- Claude Code或类似的代码执行环境

### 设置

1. 克隆此存储库:```bash
git clone https://github.com/yourusername/zotero-code-execution.git
cd zotero-code-execution
  1. 安装依赖项(可选-通常已与Zotero MCP一起安装):```bash
    pip install -r requirements.txt

3. 在代码中使用:```python
import sys
sys.path.append('/path/to/zotero-code-execution')
import setup_paths  # Adds zotero_mcp to path
from zotero_lib import SearchOrchestrator, format_results

使用示例

基本搜索```python

orchestrator = SearchOrchestrator()
results = orchestrator.comprehensive_search("neural networks", max_results=20)
print(format_results(results))


### 按作者筛选```python
library = ZoteroLibrary()
results = library.search_items("Kahneman", qmode="titleCreatorYear", limit=50)
sorted_results = sorted(results, key=lambda x: x.date, reverse=True)
print(format_results(sorted_results))

基于标签的搜索```python

library = ZoteroLibrary()
results = library.search_by_tag(["learning", "cognition"], limit=50)
print(format_results(results[:20]))


### 近期论文```python
library = ZoteroLibrary()
results = library.get_recent(limit=20)
print(format_results(results))

自定义筛选```python

library = ZoteroLibrary()
orchestrator = SearchOrchestrator(library)

items = library.search_items("AI", limit=100)

Only recent papers with DOI

recent_with_doi = [
item for item in items
if item.doi and item.date and int(item.date[:4]) >= 2020
]
print(format_results(recent_with_doi))


看 examples.py 8个完整的工作示例。

## 克劳德代码技能

此存储库包含一个Claude Code技能,便于集成。

### 安装

将技能复制到您的Claude技能目录:```bash
cp -r claude-skill ~/.claude/skills/zotero-mcp-code

用法

在Claude Code中,搜索将自动使用代码执行模式:

> “查找关于具身认知的论文”

Claude将使用此库编写代码,而不是直接调用MCP。

看 claude技能/技巧.md 获取完整的技能文档。

API 参考

SearchOrchestrator

自动多策略搜索的主类。

comprehensive_search(query, max_results=20, use_semantic=True, use_keyword=True, use_tags=True, search_limit_per_strategy=50)

通过自动重复数据删除和排名执行全面搜索。

退货: 列表 ZoteroItem 物体

filter_by_criteria(items, item_types=None, date_range=None, required_tags=None, excluded_tags=None)

按各种条件筛选项目。

退货: 筛选列表 ZoteroItem 物体

ZoteroLibrary

Zotero的底层接口。

  • search_items(query, ...) -关键字搜索
  • semantic_search(query, ...) -语义/矢量搜索
  • search_by_tag(tags, ...) -基于标签的搜索
  • get_recent(limit) -最近添加的项目
  • get_tags() -所有库标签

辅助函数

  • format_results(items, include_abstracts=True, max_abstract_length=300) -格式为markdown

看 README_LIBRARY.md 获取完整的API文档。

建筑

基于 Anthropic使用MCP执行代码:

  1. Claude编写Python代码 (非直接MCP呼叫)
  2. 代码获取大型数据集 (100+项目)来自Zotero
  3. 执行环境中的代码进程 (去噪、排序、筛选)
  4. 仅筛选结果 返回LLM上下文(20个项目)

结果: 大型数据集脱离上下文,防止崩溃并节省令牌。

演出

预期效益

基于Anthropic的模式和实现设计:

  • 代币减少: 50-90%(确切数量取决于搜索大小)
  • 函数调用: 5-10x→ 1x(经设计确认)
  • 搜索限制: 10-15 → 100+ 项目(代码安全)
  • 防撞: 可能有效(未经测试)

状态

⚠️ 概念验证 -性能声明是理论预测,而不是测量结果。

看 荣誉_状态.md 了解详细的状态和验证需求。

文档

  • README_LIBRARY.md -完整的图书馆文档
  • 快速启动.md -快速参考指南
  • CLAUDE_INSTRUCTIONS.md -克劳德代码说明
  • examples.py -8个工作示例
  • 实施_ SUMMARY.md -技术细节
  • 荣誉_状态.md -实施情况
  • claude技能/技巧.md -Claude代码技能文档

贡献

欢迎投稿!需要改进的地方:

  1. 性能验证 -衡量实际代币节省
  2. 更好的排名 -结合语义相似性得分
  3. 缓存 -缓存无效搜索结果
  4. 并行处理 -同时执行搜索策略
  5. 导出函数 -批量BibTeX生成,CSV导出

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

学分

  • 基于 Zotero MCP
  • 灵感源自 Anthropic使用MCP执行代码

相关项目

  • Zotero MCP -底层MCP服务器
  • 克劳德代码 -代码执行环境
  • FastMCP -MCP服务器框架

引用

如果你在研究中使用这个,请引用:bibtex @software{zotero_code_execution, title = {Zotero Code Execution: Efficient Multi-Strategy Search}, year = {2025}, url = {https://github.com/kerim/zotero-code-execution} }

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zotero Code Execution 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Zotero Code Execution 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zotero Code Execution 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zotero Code Execution 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zotero Code Execution 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zotero Code Execution 能提供哪些能力?

资料显示能力标签包括 文献管理、代码执行、Python、Claude。具体工具清单以官方文档为准。

Zotero Code Execution 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Zotero Code Execution 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。