Zotero MCP

Zotero MCP: Su biblioteca de investigación en Claude

Zotero MCP conecta fluidamente tu biblioteca de investigación de Zotero con Claude y otros asistentes de IA ( Cherry Studio , Cursor , etc.) mediante el Protocolo de Contexto de Modelo . ¡Comenta artículos, obtén resúmenes, analiza citas, extrae anotaciones de PDF y mucho más!

✨ Características

🔍 Busca en tu biblioteca

• Encuentre artículos, documentos y libros por título, autor o contenido.
• Realizar búsquedas complejas con múltiples criterios
• Explorar colecciones, etiquetas y adiciones recientes

📚 Accede a tu contenido

• Recupere metadatos detallados de cualquier elemento
• Obtener el contenido de texto completo (cuando esté disponible)
• Acceder a archivos adjuntos, notas y elementos secundarios

📝 Trabajar con anotaciones

• Extraer y buscar anotaciones PDF directamente
• Acceda a las anotaciones nativas de Zotero
• Crear y actualizar notas y anotaciones

🌐 Métodos de acceso flexibles

• Método local para acceso sin conexión (no se necesita clave API)
• API web para el acceso a la biblioteca en la nube
• Perfecto tanto para la investigación local como para la colaboración remota.

🚀 Instalación rápida

Instalación mediante herrería

Para instalar Zotero MCP para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Instalación mediante uv

Instalación mediante pip

🖥️ Configuración y uso

La documentación completa está disponible en Zotero MCP docs .

Requisitos

• Python 3.10+
• Zotero 7+ (para API local con acceso a texto completo)
• Claude Desktop o asistente de IA compatible

Para Claude Desktop

Configuración

Después de la instalación, puede:

1. Autoconfiguración (recomendado):
   zotero-mcp setup
2. Configuración manual : agregue a su claude_desktop_config.json :
   { "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

Uso

1. Inicie el escritorio de Zotero (asegúrese de que la API local esté habilitada en las preferencias)
2. Iniciar Claude Desktop
3. Acceda a la herramienta Zotero-MCP a través de la interfaz de herramientas de Claude Desktop

Ejemplos de indicaciones:

• "Busca artículos sobre aprendizaje automático en mi biblioteca"
• Encuentra artículos recientes que he añadido sobre el cambio climático.
• Resuma los hallazgos clave de mi artículo sobre computación cuántica.
• Extraer todas las anotaciones en PDF de mi artículo sobre redes neuronales.
• "Busca en mis notas y anotaciones menciones al 'aprendizaje por refuerzo'"

Para Cherry Studio

Configuración

Vaya a Configuración -> Servidores MCP -> Editar configuración de MCP y agregue lo siguiente:

Luego haga clic en "Guardar".

Cherry Studio también proporciona un método de configuración visual para configuraciones generales y selección de herramientas.

🔧 Configuración avanzada

Uso de API web en lugar de API local

Para acceder a su biblioteca Zotero a través de la API web (útil para configuraciones remotas):

Variables de entorno

• ZOTERO_LOCAL=true : utiliza la API local de Zotero (valor predeterminado: falso)
• ZOTERO_API_KEY : Su clave API de Zotero (para API web)
• ZOTERO_LIBRARY_ID : Su ID de biblioteca Zotero (para API web)
• ZOTERO_LIBRARY_TYPE : El tipo de biblioteca (usuario o grupo, predeterminado: usuario)

Opciones de la línea de comandos

Extracción de anotaciones de PDF

Zotero MCP incluye capacidades avanzadas de extracción de anotaciones de PDF:

• Procesamiento directo de PDF : extraiga anotaciones directamente de archivos PDF, incluso si aún no están indexados por Zotero
• Búsqueda mejorada : busque entre anotaciones y comentarios de PDF
• Compatibilidad con anotaciones de imágenes : extraiga anotaciones de imágenes de archivos PDF
• Integración perfecta : funciona junto con el sistema de anotación nativo de Zotero

Para una extracción óptima de anotaciones, se recomienda encarecidamente instalar el plugin Better BibTeX para Zotero. Las funciones relacionadas con las anotaciones se han probado principalmente con este plugin y ofrecen una funcionalidad mejorada cuando está disponible.

La primera vez que utilice las funciones de anotación de PDF, las herramientas necesarias se descargarán automáticamente.

📚 Herramientas disponibles

Herramientas de búsqueda

• zotero_search_items : Busca en tu biblioteca
• zotero_advanced_search : Realiza búsquedas complejas
• zotero_get_collections : Lista de colecciones
• zotero_get_collection_items : Obtener elementos de una colección
• zotero_get_tags : Listar todas las etiquetas
• zotero_get_recent : Obtener elementos añadidos recientemente

Herramientas de contenido

• zotero_get_item_metadata : Obtener metadatos detallados
• zotero_get_item_fulltext : Obtener el contenido de texto completo
• zotero_get_item_children : Obtener archivos adjuntos y notas

Herramientas de anotación y notas

• zotero_get_annotations : Obtener anotaciones (incluida la extracción directa de PDF)
• zotero_get_notes : recupera notas de tu biblioteca de Zotero
• zotero_search_notes : busca en notas y anotaciones (incluidas las extraídas de PDF)
• zotero_create_note : Crea una nueva nota para un artículo (función beta)

🔍 Solución de problemas

• No se encontraron resultados : Asegúrese de que Zotero se esté ejecutando y que la API local esté habilitada
• No se puede conectar a la biblioteca : Verifique su clave API y el ID de la biblioteca si usa la API web
• Texto completo no disponible : asegúrese de estar utilizando Zotero 7+ para el acceso local al texto completo

📄 Licencia

Instituto Tecnológico de Massachusetts (MIT)