DataCore A2A — MCP server

Ermöglicht einem MCP-Client (Claude Code, Claude Desktop, VS Code, Cursor…) die Datenskills von DataCore als native Tools zu nutzen: Normalisierung vietnamesischer Adressen, Adressprüfung, Unternehmenssuche, Embedding-Erzeugung.

MCP client (stdio) ──► datacore-mcp ──HTTPS──► DataCore API

Zero-Dependency, Python 3.9+.

Installation

pip install datacore-a2a-mcp

Related MCP server: database-remote-mcp

Voraussetzungen

Dieser Server ist ein Client, kein Dienst. Er benötigt einen DataCore-Endpunkt und ein Mandate-Token für Aufrufe – kontaktieren Sie 3TIT, um diese zu erhalten. Ohne diese beiden Dinge startet der Server und beendet sich sofort mit einer Meldung, welche Variable fehlt.

Konfiguration

Verwenden Sie die korrekte, von DataCore mit dem Mandate ausgegebene URL. Ein anderer Endpunkt akzeptiert Ihr Mandate nicht und gibt 401 zurück.

Claude Code / Claude Desktop

Fügen Sie Folgendes zu .mcp.json (Projekt) oder der Konfiguration von Claude Desktop hinzu:

{
  "mcpServers": {
    "datacore-a2a": {
      "command": "datacore-mcp",
      "env": {
        "DATACORE_A2A_URL": "https://api.example.com",
        "DATACORE_MANDATE": "<mandate-token>"
      }
    }
  }
}

Tools

Die Tool-Liste wird vom Endpunkt generiert, nicht hier hartkodiert – wenn DataCore also einen Skill hinzufügt, erscheinen die neuen Tools nach einem Server-Neustart.

Standardmäßig werden 4 Skills mit echtem Backend exponiert:

Alle Tools sind read-only (readOnlyHint: true): nichts wird geschrieben, gelöscht oder erstellt. Derselbe Input liefert dasselbe Ergebnis.

Drei weitere DataCore-Skills (company.graph, company.financial-sankey, company.news) sind bewusst nicht exponiert: Sie liefern derzeit Mock-/deterministische Daten. Wenn Sie sie zum Testen sehen möchten, setzen Sie DATACORE_SKILLS="*" – und vertrauen Sie den Ergebnissen nicht.

Beispiele

Die folgenden drei Prompts laufen über drei verschiedene Tools:

1. Adressnormalisierung – „Normalisiere diese Adresse in Provinz/Bezirk/Gemeinde: So 1 Ly Thai To, Hoan Kiem, Ha Noi“

2. Unternehmenssuche – „Suche Informationen zum Unternehmen mit der Steuernummer 0100109106 und nenne mir den Betriebsstatus“

3. Embedding – „Erzeuge ein Embedding für diese Branchenbeschreibung und gib an, wie viele Dimensionen der Vektor hat: Großhandel mit elektronischen Geräten“

Sicherheitsmodell

Dieser Server überträgt das Mandate-Token unverändert im Header X-AP2-Mandate zur Verifizierung durch DataCore und setzt selbst keine anderen Authorization-Header. Ein Client ist nicht der Ort, an dem er sich selbst autorisiert – er leitet nur weiter, was ihm gewährt wurde; alle Entscheidungen über Erlauben oder Verweigern liegen bei DataCore.

Das Mandate ist eine Bearer-Credential: Wer es besitzt, kann genau die darin enthaltenen Skills aufrufen, bis zum Ausgabenlimit und bis zum Ablauf. Behandeln Sie es wie ein Passwort – committen Sie keine .mcp.json mit eingetragenem Token, und lesen Sie es, falls Ihr Client das unterstützt, aus einem Secret-Manager statt es inline zu setzen.

Dieses Package schreibt das Token niemals in Logs, auch nicht teilweise; ebenso wenig den von Ihnen gesendeten text-Inhalt. Das ist die Zusage für den Prozess auf Ihrem Rechner – die Dienstseite ist eine andere Sache, und PRIVACY.md sagt klar, was dort gespeichert wird.

Fehlerbehebung

Logs gehen auf stderr, Präfix [datacore-mcp]. stdout ist der JSON-RPC-Kanal.

Sicherheitslücken melden

mcp-security@datacore.vn. Öffnen Sie für Sicherheitslücken kein öffentliches Issue.

Wenn Sie vermuten, dass Ihr Mandate kompromittiert wurde, melden Sie das sofort – warten Sie nicht bis zum Ablauf. Wir müssen es wissen, um dienstseitig zu handeln.

Datenschutz

Siehe PRIVACY.md. Kurz: Dieses Package läuft auf Ihrem Rechner, speichert nichts, sendet nichts außer an den von Ihnen konfigurierten DataCore-Endpunkt und schreibt das Mandate-Token niemals in Logs.

Lizenz

MIT – siehe LICENSE.