Skip to main content

A Model Context Protocol (MCP) server for interacting with Zotero libraries

Project description

zotero_mcp

English | 中文

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, and your library_id is shown below:
library_id

Then start the server:

python ./server.py

Open a new terminal window and run the client:

python ./client.py

Here's the testing result:

Upload files in Zotero in advance:

Zotero upload screenshot

Query document content via MCP:

Query document content screenshot

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz (12.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 48ddc6f7f3c3c516ce0628af4770f2d7e3b51ad40f4745d47a1089459cff3283
MD5 d0f6762c48068cac44cf6b98cb708ac8
BLAKE2b-256 171cc07c883008b3779873196cddecfd71c9f52fa431f4ea47bb443ec2972c70

See more details on using hashes here.

File details

Details for the file iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 19.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4ff3c9c12f566a78cac313fd63d147fb01de6cc4f9cc0239dc83e2d84d0182ca
MD5 506d14c2d0421f060ec40946f72f91d6
BLAKE2b-256 f3ea07aed23a74957ef571c7947b69c5be5be680f499f0669f56318caa8885c3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page