Zotero MCP Server

Zotero MCP Server

site icon
2025.03.28 0
Python文献管理笔记管理开发效率
Zotero MCP Server 是一个基于 MCP(Model Context Protocol)的服务器,旨在让 MCP 客户端(如 Anthropic Claude App、Goose 或 vscode Cline)能够与本地 Zotero 文献库进行交互。该服务器提供了对 Zotero 库的程序化访问能力,支持搜索文献、管理笔记等功能。
View on GitHub

Overview

基本能力

产品定位

Zotero MCP Server 是一个用于文献管理和笔记管理的工具,旨在通过 MCP 协议提供对 Zotero 库的程序化访问。

核心功能

  • 搜索文献(按标签等条件)
  • 获取文献详情和附加笔记
  • 为文献添加笔记
  • 请求文献摘要

适用场景

  • 研究人员需要快速访问和管理文献库
  • 开发者希望通过程序化方式与 Zotero 交互
  • 需要将 Zotero 集成到其他工具(如 Claude App)中

工具列表

  • uv:用于运行 Python 模块的工具
  • bash:用于执行脚本和命令的工具

常见问题解答

  • 如果遇到 --directory 参数错误,请改用 bash 命令并确保激活虚拟环境。

使用教程

使用依赖

  1. 安装依赖:
pip install -e .
  1. 创建 .env 文件并填写 Zotero 凭证:
ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here

安装教程

  1. 克隆项目并进入目录。
  2. 运行 uv venv 创建虚拟环境。
  3. 激活虚拟环境:
source .venv/bin/activate
  1. 安装开发依赖:
uv pip install ".[dev]"

调试方式

  1. 确保虚拟环境已激活。
  2. 运行服务器:
python -m zotero_mcp.server
  1. 检查日志输出以确认服务器正常运行。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。