### 我的环境:

• Windows 11 Professional 24H2
• x86 platform
• uv 0.6.14
• zotero 7.0.15 (64-bit)

### 关于Cherry Studio
Cherry Studio 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台。现在它已经支持MCP，并且完全开源。（https://github.com/CherryHQ/cherry-studio）。

### Installation/安装过程

1. 克隆项目库到本地
   git clone https://github.com/TomasSchweizer/Zotero-MCP-Server.git

2. Cherry Studio只能使用内置的UV，所以需要现在软件内下载UV，然后找到启动路径。默认路径是在"C:\Users(your user name).cherrystudio\bin"。单击下图所示这个路径就能在资源管理器中打开UV.exe的目录。记住这个目录，后续操作用这个目录下的UV.exe安装依赖。

3. 你需要在存储库的根目录手动创建一个txt文件，填入zotero库id和库用户环境变量，并改名为".env"。如果不知道怎么获得八位数字组成的zotero库id，你要双击zotero库，在弹出的网页的网址中获取这八位数字。这个网址是"https://www.zotero.org/users/**XXXXXXXX**/items"。
   LIBRARY_ID="xxxxxxxx" # 8 digits
LIBRARY_TYPE="user"

4. 接下来按照作者的提示创建venv, 安装依赖和包。但是在命令前加上第二步获取的文件目录。
   C:\Users\(your user name)\.cherrystudio\bin\uv venv
C:\Users\(your user name)\.cherrystudio\bin\uv sync
C:\Users\(your user name)\.cherrystudio\bin\uv pip install .

5. 配置Cherry Studio，如下图所示。命名，选择类型为"stdio"，命令为UV，以及填写参数。或者编辑JSON文件，复制以下代码，并把“--directory”后面的路径换成你的存储库根目录。

{
  "mcpServers": {
    "zoteroMCP": {
      "isActive": true,
      "name": "Zotero-MCP-Server",
      "key": "ZoteroMCPServer",
      "type": "stdio",
      "description": "A simple MCP server which allows querying PDFs and Notes from Zotero.",
      "registryUrl": "",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "D:/GithubProject/Zotero-MCP-Server",
        "-m",
        "src.zotero_mcp_server.zotero_mcp_server"
      ]
    }
  }
}

安装完成。但是别忘了检查是否在zotero的设置中开启“允许此计算机上的其他应用程序与Zotero通信”。