🚀 Zotero MCP 服务器

Zotero MCP 服务器是一个集成到 Zotero 的 Model Context Protocol (MCP) 服务器，它为 AI 应用程序提供了访问和操作 Zotero 图书馆的能力，极大地拓展了 Zotero 的应用场景。

✨ 主要特性

• 搜索功能：可在 Zotero 图书馆中搜索项目。
• 引文获取：能够获取引文和 bibliography。
• 项目添加：支持向 Zotero 图书馆添加新项目。
• 资源访问：允许访问集合和项目。
• 多类型支持：同时支持个人和组图书馆。

📦 安装指南

克隆仓库

git clone https://github.com/your-username/zotero-mcp-server.git
cd zotero-mcp-server

创建虚拟环境

python -m venv venv

激活虚拟环境

• Linux/macOS 系统：

source venv/bin/activate

• Windows 系统：

venv\Scripts\activate

安装依赖项

pip install -r requirements.txt

📚 详细文档

配置步骤

复制示例环境文件

cp .env.example .env

编辑 .env 文件

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_numeric_user_id_here
# ZOTERO_GROUP_ID=your_group_id_here  # 解注以使用组图书馆

你需要设置 ZOTERO_USER_ID（用于个人图书馆）或 ZOTERO_GROUP_ID（用于组图书馆）。

查找 Zotero 用户 ID

如果你不确定如何找到你的 Zotero 用户 ID，请运行：

./find_zotero_id.py

使用说明

运行服务器

python src/server.py

服务器将启动并监听标准输入/输出上的 JSON-RPC 请求。

测试服务器

./simple_test.py

这将运行一系列测试以验证服务器是否正常工作。

与 AI 应用程序集成

Zotero MCP 服务器可以与支持 Model Context Protocol 的 AI 应用程序集成。请参阅 USAGE_GUIDE.md 文件获取详细示例。

可用资源

可用工具

其他文档资源

有关更多详细信息，请参阅：

• USAGE_GUIDE.md：详细的使用指南
• test_client.py：交互式测试客户端
• simple_test.py：简单的测试脚本
• find_zotero_id.py：帮助查找你的 Zotero ID 的脚本

📄 许可证

本项目采用 MIT 许可证。

💪 贡献

欢迎大家贡献代码！请随意提交 Pull Request。