eiu-mcp-server

Ein Model Context Protocol-Server, der Claude (oder einem beliebigen MCP-kompatiblen LLM-Client) strukturierten, token-effizienten Zugriff auf die EIU-Daten-API bietet — rund 200 Länder und 320 Wirtschaftsindikator-Serien, historische Daten und Prognosen.

Er stellt drei Tools bereit:

Referenzdaten werden einmal pro Sitzung geladen und im Speicher zwischengespeichert, sodass Durchsuchen und Suchen keine weiteren API-Aufrufe kosten.

Voraussetzungen

• Zugang zum EIU API Developer Portal. Die Einrichtung erfolgt nicht im Self-Service. Schreiben Sie an economicssupport@economist.com und bitten Sie um Zugang zum Developer Portal. Ihr Konto wird manuell eingerichtet. Sie benötigen alle drei Angaben: Ihre Portal-E-Mail-Adresse, Ihr Portal-Passwort und den im Portal angezeigten API-Schlüssel.

• Auf Ihrem Rechner muss uv installiert sein. Einzeiler:

  curl -LsSf https://astral.sh/uv/install.sh | sh

Sie müssen dieses Repository nicht klonen oder eine virtuelle Umgebung verwalten – uvx erledigt alles über die Git-URL.

Related MCP server: EODHD MCP Server

Installation

Claude Code

Die Installation per Einzeiler, ausgeführt aus einem Ordner, dessen .env Ihre drei EIU-Werte enthält. Die Shell liest sie ein, sodass die Anmeldedaten nie in Ihrer Konversation auftauchen:

set -a; source .env; set +a
claude mcp add --scope user eiu \
  -e EIU_API_KEY="$EIU_API_KEY" \
  -e EIU_EMAIL="$EIU_EMAIL" \
  -e EIU_PASSWORD="$EIU_PASSWORD" \
  -- uvx --from git+https://github.com/joshua-bailey/eiu-mcp-server.git eiu-mcp-server

Oder fügen Sie den Eintrag von Hand in .mcp.json hinzu:

{
  "mcpServers": {
    "eiu": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/joshua-bailey/eiu-mcp-server.git",
        "eiu-mcp-server"
      ],
      "env": {
        "EIU_API_KEY": "${EIU_API_KEY}",
        "EIU_EMAIL": "${EIU_EMAIL}",
        "EIU_PASSWORD": "${EIU_PASSWORD}"
      }
    }
  }
}

Starten Sie dann Claude Code neu. Die drei eiu_*-Tools sollten unter /mcp erscheinen.

Claude Desktop

Dasselbe JSON-Snippet, eingefügt unter mcpServers in:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop löst keine ${VAR}-Referenzen auf; tragen Sie dort stattdessen die tatsächlichen Werte ein.

Eine Version festlegen

uvx installiert standardmäßig den neuesten Commit auf main. Um eine Version auf ein bestimmtes Release-Tag festzulegen, hängen Sie @<tag> an die Git-URL an, z. B.:

"git+https://github.com/joshua-bailey/eiu-mcp-server.git@v0.1.0"

Umgebungsvariablen

Alle drei werden benötigt. Der Server meldet sich mit E-Mail-Adresse und Passwort an, um ein Bearer-Token zu erhalten, und sendet dieses Token zusammen mit dem API-Schlüssel bei jeder Anfrage. Das Token wird im Speicher zwischengespeichert und vor Ablauf aktualisiert.

Verwendung

Sobald der MCP registriert ist, können Sie Claude zum Beispiel Folgendes fragen:

• „Suche in EIU nach Serien zum Leistungsbilanzsaldo"

• „Welche EIU-Seriencodes decken Verbraucherpreise ab?"

• „Rufe EIU-Daten zum jährlichen BIP-Wachstum (DGDP) für die USA, Großbritannien und China von 2015 bis 2030 ab"

• „Zeig mir EIU-Prognosen zur vierteljährlichen Inflation für Brasilien, Mexiko und Chile"

Claude wählt das passende Tool aus und ruft es auf.

Codes

• Geografien sind zweistellige ISO-Codes in Großbuchstaben: US, GB, CN, BR.

• Serien sind EIU-eigene Kurzcodes in Großbuchstaben, z. B. DGDP, DCPI. Nutzen Sie eiu_search oder eiu_browse, um sie zu finden, statt zu raten.

• Häufigkeit ist einer der Werte Yearly, Quarterly oder Monthly.

eiu_get_data begrenzt die Antwort auf 200 Datenpunkte, um token-effizient zu bleiben, und weist darauf hin, wenn es die Antwort kürzt. Verkleinern Sie den Datumsbereich oder die Länderliste, um den Rest zu sehen.

API-Referenz

Die zugrunde liegende API ist unter developer.eiu.com/help/overview dokumentiert. Der Server kommuniziert mit https://api.eiu.com/v1.

Lizenz

MIT – siehe LICENSE. Gilt nur für den Wrapper-Code in diesem Repository. Abhängigkeiten behalten ihre eigenen Lizenzen. EIU-Daten sind ein kostenpflichtiges Abonnement, dessen Nutzungsbedingungen unabhängig von diesem Wrapper gelten.