MCP Zotero

MCP Zotero

Um servidor Model Context Protocol para integração com o Zotero que permite ao Claude interagir com sua biblioteca do Zotero.

Configuração

1. Obtenha suas credenciais do Zotero:

   # First, create an API key at https://www.zotero.org/settings/keys
   # Then use it to get your user ID:
   curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current
   

   A resposta será semelhante a:

   {
     "userID": 123456,
     "username": "your_username",
     "access": {
       "user": {
         "library": true,
         "files": true,
         "notes": true,
         "write": true
       }
     }
   }
   

   O valor de userID é o que você precisa.

2. Defina as variáveis de ambiente:

   export ZOTERO_API_KEY="your-api-key"
   export ZOTERO_USER_ID="user-id-from-curl"
   

3. Verifique suas credenciais:

   # Test that your credentials work:
   curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
        "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"
   

   Você deve ver sua lista de coleções na resposta.

4. Instale e execute:

   # Install globally (recommended)
   npm install -g mcp-zotero
   mcp-zotero
   
   # Or run directly with npx
   npx mcp-zotero
   

Integração com o Claude Desktop

Para usar este servidor com o Claude Desktop, adicione o seguinte à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": YOUR_API_KEY,
        "ZOTERO_USER_ID": YOUR_USER_ID
      }
    }
  }
}

Ferramentas Disponíveis

• get_collections: Lista todas as coleções da sua biblioteca
• get_collection_items: Obtém itens de uma coleção específica
• get_item_details: Obtém informações detalhadas sobre um artigo
• search_library: Pesquisa em toda a sua biblioteca
• get_recent: Obtém artigos adicionados recentemente

Solução de Problemas

Se você encontrar algum problema:

1. Verifique se suas variáveis de ambiente estão definidas:

   echo $ZOTERO_API_KEY
   echo $ZOTERO_USER_ID
   

2. Verifique a instalação:

   npm list -g mcp-zotero
   

3. Tente reinstalar:

   npm uninstall -g mcp-zotero
   npm install -g mcp-zotero