# MCP-Zotero-Benchmark-Report

**Erstellt:** 2026-08-11T21:50:55.347562+00:00  
**Test-Item:** `YOUR_TEST_ITEM_KEY`  
**Bibliothek:** user YOUR_LIBRARY_ID  
**Gesamtlaufzeit:** 24.4s
**MCP-Tool-Timeout:** 15s

Alle Zeiten in Sekunden, gemessen auf dem Agenten-Rechner (Linux-VM). Der MCP-Server läuft auf dem Windows-Rechner (`YOUR_WINDOWS_HOST`) und wird über SSH+PowerShell gestartet.

## Ergebnisse

| Operation | MCP-Server (SSH) | Lokale HTTP-API | pyzotero (local=True) |
|-----------|------------------|-----------------|-----------------------|
| Initialisierung/Verbindung | 2.98s | — | — |
| list_tools / — | 0.06s | — | — |
| list_libraries | 0.20s | — | — |
| get_recent(limit=5) | 2.27s | — | — |
| get_collections | 2.08s | — | — |
| Item-Metadaten | 2.04s | 0.01s | 0.01s |
| Kinder/Attachments | 4.07s | — | 0.07s |
| Volltext/PDF | 2.09s | 0.01s | 0.06s |
| Suche/Top-20 Items | 7.30s | 0.20s | 0.20s |

## Beobachtungen

- Der MCP-Server benötigt eine SSH-Verbindung und den Start von PowerShell; die Initialisierung dauert daher länger als ein direkter HTTP-Aufruf.
- Sobald der Server läuft, liegen die meisten Tool-Aufrufe im Bereich weniger Sekunden. In manchen Läufen treten jedoch Timeouts oder Server-Abstürze (`AssertionError: Request already responded to`) auf; der Benchmark fängt diese mit Timeouts ab, damit die übrigen Messungen nicht blockiert werden.
- Die lokale Zotero-HTTP-API arbeitet schneller und stabiler als der MCP-Server über SSH; für reine Lesezugriffe ist sie der effizienteste Weg.
- `pyzotero` mit `local=True` greift auf dieselbe lokale Zotero-API zu wie die direkten HTTP-Aufrufe; Unterschiede in der Geschwindigkeit liegen dann am Overhead des Python-Clients.
- PDF-Volltexte funktionieren über alle drei Wege, wenn man den Attachment-Key verwendet (lokale API und `pyzotero`) bzw. den Parent-Key (MCP-Server). Der MCP-Server löst den Attachment-Key intern auf.
- Die lokale HTTP-API ist der schnellste Weg, liefert aber nur lesenden Zugriff und keine semantische Suche.

## Konfiguration

```json
{
  "local_api": "http://127.0.0.1:23119/api",
  "config": "~/.kimi-code/mcp.json",
  "mcp_tool_timeout": 15
}
```