Zotero MCP Server

🚀 Zotero MCP Server

A Model Context Protocol (MCP) server integrated into Zotero, allowing AI applications to access and manipulate Zotero libraries.

✨ Features

• Search for items in the Zotero library.
• Retrieve citations and bibliographies.
• Add new items to the Zotero library.
• Access collections and items.
• Support both personal and group libraries.

📦 Installation

1. Clone the repository:

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

2. Create a virtual environment:

   python -m venv venv
   

3. Activate the virtual environment:
   • On Linux/macOS:

     source venv/bin/activate
     

   • On Windows:

     venv\Scripts\activate
     

4. Install the dependencies:

   pip install -r requirements.txt
   

📚 Configuration

1. Copy the example environment file:

   cp .env.example .env
   

2. Edit the .env file with your Zotero API credentials:

   ZOTERO_API_KEY=your_api_key_here
   ZOTERO_USER_ID=your_numeric_user_id_here
   # ZOTERO_GROUP_ID=your_group_id_here  # Uncomment to use a group library
   

   You need to set either ZOTERO_USER_ID (for a personal library) or ZOTERO_GROUP_ID (for a group library).
3. If you're unsure how to find your Zotero user ID, run:

   ./find_zotero_id.py
   

💻 Usage Examples

Basic Usage

Run the server

python src/server.py

The server will start and listen for JSON - RPC requests on standard input/output.

Test the server

./simple_test.py

This will run a series of tests to verify that the server is working correctly.

Advanced Usage

Integrate with AI applications

The Zotero MCP server can be integrated with AI applications that support the Model Context Protocol. Refer to the USAGE_GUIDE.md file for detailed examples.

📚 Documentation

Available Resources

• zotero://collections: List of collections in the Zotero library.
• zotero://items/top: Top - level items in the library.
• zotero://items/recent: Recently added or modified items.
• zotero://collections/{collection_key}/items: Items in a specific collection.
• zotero://items/{item_key}: Details of a specific Zotero item.
• zotero://items/{item_key}/citation/{style}: Citation of a specific item in a specific format.

Available Tools

• search_items: Search for items in the Zotero library.
• get_citation: Retrieve the citation of a specific item.
• add_item: Add a new item to the Zotero library.
• get_bibliography: Retrieve the bibliography for multiple items.

More Information

For more detailed information, please refer to:

• USAGE_GUIDE.md: Detailed usage guide.
• test_client.py: Interactive test client.
• simple_test.py: Simple test script.
• find_zotero_id.py: Script to help find your Zotero ID.

📄 License

MIT

🔧 Contribution

Contributions are welcome! Feel free to submit a Pull Request.