← ClaudeAtlas

mcp-data-fidelitylisted

Datentreue-Regeln für MCP-Server-Tools, die eine externe Datenquelle abfragen — damit ein Server nicht still unvollständig liefert. Verwende diesen Skill ergänzend zu mcp-builder immer wenn (1) ein Such-, Query- oder Filter-Tool für einen MCP-Server entworfen oder implementiert wird, (2) eine Tool-Description für ein datenabfragendes Tool geschrieben oder überarbeitet wird, (3) jemand meldet, ein Server finde nichts, zu wenig oder weniger als die offizielle Oberfläche («findet nichts», «leeres Ergebnis», «Web-UI zeigt mehr», «zu wenig Treffer», «Recall», «Scope»), (4) ein Modell auf ein leeres Tool-Result hin eine Antwort erfunden hat, (5) optionale API-Parameter (Filter, Facetten, Feld-Flags, Limits) in Requests übersetzt werden, oder (6) Tests für ein datenabfragendes Tool geschrieben werden. Nicht nötig für Server ohne externe Datenquelle.
malkreide/mcp-data-source-probe-skill · ★ 0 · AI & Automation · score 72
Install: claude install-skill malkreide/mcp-data-source-probe-skill
# MCP Data Fidelity — liefert der Server, was die Quelle hat? Companion zu `mcp-builder`. Dessen Best Practices decken ab, ob ein Server **korrekt gebaut** ist — Naming, Annotations, Pagination, Transport, Fehlerbehandlung. Dieser Skill deckt die Frage daneben ab: **liefert er, was die Quelle tatsächlich hat?** Das ist eine eigene Fehlerklasse, weil sie still ist. HTTP 200, wohlgeformtes JSON, grüne Tests — und inhaltlich falsch. Ein Server, der zwei Prozent des Bestands durchsucht und das nicht meldet, produziert Antworten, die niemand als falsch erkennt. **Die Leitfrage bei jedem datenabfragenden Tool:** *Wenn dieses Tool nichts findet — kann ich unterscheiden, ob es nichts gibt oder ob ich falsch gefragt habe?* Ist die Antwort nein, greift eine der fünf Regeln unten. --- ## Regel 1 — Scope-Parameter explizit senden, nie erben Ein optionaler Filter-Parameter bedeutet beim Weglassen oft **nicht** «unbeschränkt», sondern einen willkürlichen Teilausschnitt. Diese Tatsache steht ausschliesslich in der **Parameterbeschreibung** der Spec — nicht im Response-Schema, nicht im Doku-Beispiel, und an einem funktionierenden Call ist sie nicht erkennbar. Verbreitete Vertreter: | Quelle | Parameter | Default bei Weglassen | |---|---|---| | CKAN `package_search` | `rows` | 10 Treffer | | WFS `GetFeature` | `count` / `maxFeatures` | serverseitiges Limit | | SPARQL | `FROM` / Named Graphs | nur Default-Graph | | Elasticsearch / Solr | `size`, `fq`, `df` | 10 Hits, eingeschränktes De