https://github.com/LRriver/zotero_mcp
Support connecting zotero via MCP, with custom server and client, without the need for tools like the Claude app, Cursor, etc.
https://github.com/LRriver/zotero_mcp
Last synced: about 2 months ago
JSON representation
Support connecting zotero via MCP, with custom server and client, without the need for tools like the Claude app, Cursor, etc.
- Host: GitHub
- URL: https://github.com/LRriver/zotero_mcp
- Owner: LRriver
- License: apache-2.0
- Created: 2025-06-02T08:35:15.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-20T03:01:34.000Z (5 months ago)
- Last Synced: 2025-06-20T03:39:19.726Z (5 months ago)
- Language: Python
- Size: 1.27 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **zotero_mcp** - Support connecting zotero via MCP, with custom server and client, without the need for tools like the Claude app, Cursor, etc. `python` `mcp` `server` `pip install git+https://github.com/LRriver/zotero_mcp` (AI/ML)
- awesome-mcp-servers - **zotero_mcp** - Support connecting zotero via MCP, with custom server and client, without the need for tools like the Claude app, Cursor, etc. `python` `mcp` `server` `pip install git+https://github.com/LRriver/zotero_mcp` (π€ AI/ML)
README
# zotero_mcp
[English](./README.md) | [δΈζ](./README_zh.md)
Support connecting Zotero via MCP with a custom server and client, without the need for tools like the Claude app or Cursor.
## Environment configuration
```
conda create -n mcp python=3.12 -y
conda activate mcp
pip install -r requirements.txt
```
## Run MCP
First, create a `.env` file and fill in the following variables. `zotero_api_key` needs to be obtained from the Zotero official website, and `api_key` is your LLM's API key:
```
zotero_api_key=''
api_key=""
```
First, create a `.env` file and fill in the following variables:
```
model=""
llm_api_base = ""
llm_api_key=""
zotero_api_key=''
library_id=''
```
`model` is the name of the LLM, `llm_api_base` is the URL of the LLM, and `llm_api_key` is the API Key for the LLM. The `zotero_api_key` can be created by visiting the [Zotero](https://www.zotero.org/settings/keys), and your [library_id](https://www.zotero.org/settings/keys) is shown below:

Then start the server:
```bash
python ./server.py
```
Open a new terminal window and run the client:
```bash
python ./client.py
```
Here's the testing result:
Upload files in Zotero in advance:

Query document content via MCP:
