🚀 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 文件获取详细示例。
可用资源
| 属性 | 详情 |
|---|---|
zotero://collections |
Zotero 图书馆中的集合列表 |
zotero://items/top |
图书馆中的顶级项目 |
zotero://items/recent |
最近添加或修改的项目 |
zotero://collections/{collection_key}/items |
特定集合中的项目 |
zotero://items/{item_key} |
特定 Zotero 项目的详细信息 |
zotero://items/{item_key}/citation/{style} |
特定项目的特定格式的引文 |
可用工具
| 属性 | 详情 |
|---|---|
search_items |
在 Zotero 图书馆中搜索项目 |
get_citation |
获取特定项目的引文 |
add_item |
添加新项目到 Zotero 图书馆 |
get_bibliography |
多个项目获取 bibliography |
其他文档资源
有关更多详细信息，请参阅：
USAGE_GUIDE.md：详细的使用指南test_client.py：交互式测试客户端simple_test.py：简单的测试脚本find_zotero_id.py：帮助查找你的 Zotero ID 的脚本
📄 许可证
本项目采用 MIT 许可证。
💪 贡献
欢迎大家贡献代码！请随意提交 Pull Request。