hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides access to your Zotero library, allowing you to search for items, retrieve detailed metadata, and access the full text contents of PDFs and other documents stored in your Zotero collection.

Servidor de protocolo de contexto de modelo para Zotero

Este proyecto es un servidor Python que implementa el Protocolo de Contexto de Modelo (MCP) para Zotero , lo que permite acceder a la biblioteca de Zotero dentro de los asistentes de IA. Su objetivo es implementar un conjunto pequeño, pero de máxima utilidad, de interacciones con Zotero para su uso con clientes MCP .

Características

Este servidor MCP proporciona las siguientes herramientas:

zotero_search_items : busca artículos en tu biblioteca de Zotero mediante una consulta de texto
zotero_item_metadata : Obtenga información detallada de metadatos sobre un elemento específico de Zotero
zotero_item_fulltext : Obtener el texto completo de un elemento específico de Zotero (es decir, contenido PDF)

Se puede descubrirlos y acceder a ellos a través de cualquier cliente MCP o a través del Inspector MCP .

Cada herramienta devuelve texto formateado que contiene información relevante de sus elementos de Zotero, y los asistentes de IA como Claude pueden usarlos secuencialmente, buscando elementos y luego recuperando sus metadatos o contenido de texto.

Instalación

Para usar esto con Claude Desktop, agregue lo siguiente a la configuración mcpServers :

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

La configuración ZOTERO_LOCAL apunta el complemento a la API local de Zotero y requiere que Zotero 7 (o la versión beta, consulte la nota a continuación) se ejecute en la misma máquina que el cliente.

Para utilizar la API web de Zotero, deberá crear una clave API y encontrar su ID de biblioteca (generalmente su ID de usuario) en la configuración de su cuenta de Zotero aquí: https://www.zotero.org/settings/keys

Las siguientes variables de entorno proporcionan opciones de configuración:

ZOTERO_LOCAL=true : utiliza la API local de Zotero (valor predeterminado: falso, consulte la nota a continuación)
ZOTERO_API_KEY : Su clave API de Zotero (no es necesaria para la API local)
ZOTERO_LIBRARY_ID : Su ID de biblioteca de Zotero (su ID de usuario para bibliotecas de usuario, no es necesario para la API local)
ZOTERO_LIBRARY_TYPE : El tipo de biblioteca (usuario o grupo, predeterminado: usuario)

[!IMPORTANTE] Para acceder a la API de texto completo localmente, se requiere una próxima versión de Zotero. Mientras tanto, deberá instalar una versión beta de Zotero para que esta funcionalidad funcione (a partir del 7 de marzo de 2025). Consulte https://github.com/zotero/zotero/pull/5004 para obtener más información.

Desarrollo

Clonar este repositorio
Instale las dependencias con uv ejecutando: uv sync
Cree un archivo .env en la raíz del proyecto con las variables de entorno anteriores

Iniciar el Inspector MCP para el desarrollo local:

npx @modelcontextprotocol/inspector uv run zotero-mcp

Ejecución de pruebas

Para ejecutar el conjunto de pruebas:

uv run pytest

Documentación relevante

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Este servidor permite a los usuarios interactuar con su biblioteca Zotero a través del Protocolo de Contexto de Modelo, proporcionando herramientas para buscar elementos, recuperar metadatos y acceder a texto completo mediante consultas en lenguaje natural.

Related Resources

Reddit Discussion about this server

Zotero MCP Server