MCP - Verbindung mit Claude / Cursor

Der AstroWay Model Context Protocol Server stellt alle 771 Endpunkte als Tools für den AI-Agenten bereit. Zwei Modi – beide werden nativ von allen MCP-kompatiblen Clients unterstützt.

Modus	URL / Befehl	Wann wählen
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai im Browser), Claude Desktop / Cursor / Code-Neulinge ohne npm, oder wenn du eine Zero-Install-Lösung möchtest
Stdio (npm)	npx @astroway/mcp	Cursor Power-User, lokale Entwicklung, datenschutzbewusst (der Schlüssel verlässt niemals deinen Rechner), offline-fähig

Der gehostete Endpunkt und das npm-Paket verwenden denselben Tool-Katalog (generiert aus einer einzigen /v1/openapi.json). Auth: Derselbe aw_test_* / aw_live_* API-Schlüssel – im gehosteten Modus wird er über den Authorization: Bearer … Header gesendet, im Stdio-Modus über die ASTROWAY_API_KEY Umgebungsvariable.

Quelle: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · gehostet: mcp.astroway.info/health

Gehostet (mcp.astroway.info) – Zero-Install

Schnellstart ohne npm – wähle deinen Client. Bevor du installierst, hole dir deinen Schlüssel unter api.astroway.info/dashboard/sign-up (10.000 Credits/Monat kostenlos).

Cursor (one-click)

Klicke auf den Button – Cursor öffnet sich, fragt nach Bestätigung und fügt den Eintrag automatisch hinzu:

In Cursor installieren →

Obligatorischer 2. Schritt – sonst funktioniert es nicht

Cursor kann das Geheimnis aus dem Deeplink nicht einfügen – in ~/.cursor/mcp.json wird der Literal Bearer YOUR_API_KEY geschrieben, worauf der Server mit 403 invalid_format antwortet.

Nach dem Klick auf den Button:

1. Cursor Settings (⚙️ obere rechte Ecke) → Tools & MCP → finde astroway-hosted in der Liste.
2. Klicke auf die drei Punkte (⋯) neben dem Server → Edit configuration.
3. Ersetze im Feld Authorization Bearer YOUR_API_KEY durch Bearer aw_test_… (oder aw_live_…) – deinen echten Schlüssel vom Dashboard.
4. Speichere → öffne die MCP-Liste erneut → stelle sicher, dass der Status enabled + grüner Punkt + Zähler 780+ tools enabled ist.

Alternativ – bearbeite die Datei direkt: ~/.cursor/mcp.json (headers.Authorization).

Hinweis

Cursor legt ein Limit für die Namenslänge fest: server_name:tool_name ≤ 60 Zeichen. Etwa 90 der über 780 Tools (hauptsächlich die Gruppen hellenistic_*, psychological_*, zi_wei_*, zodiac_* und numerology_*) werden von Cursor gefiltert und sind über LLM nicht verfügbar. Die anderen ~690 funktionieren. In Claude Desktop gibt es kein solches Limit – der vollständige Katalog ist verfügbar.

Claude Desktop

Settings → Developer → Edit Config öffnet claude_desktop_config.json. Diese Datei führt nur lokale Befehle aus: Ein Eintrag mit nur url wird mit der Meldung “Some MCP servers couldn’t be loaded” übersprungen. Der gehostete Server wird über die mcp-remote-Brücke verbunden, dafür ist Node.js erforderlich:

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

Schließe Claude Desktop vollständig (Cmd+Q) und öffne es erneut. Der Schlüssel liegt in env, da Claude Desktop unter Windows das Argument nach Bearer bei einem Leerzeichen trennt.

Der Dialog Add custom connector unter Settings → Connectors akzeptiert nur Name und URL, es gibt kein Feld für den Authorization-Header, daher kann der AstroWay-Schlüssel derzeit nicht darüber übergeben werden.

JSON config (manual)

Für Cursor, Cline, Continue und Windsurf, die eine Remote-url direkt akzeptieren:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Pfade zu den Konfigurationen:

• Cursor: ~/.cursor/mcp.json (global) oder .cursor/mcp.json (im Workspace)
• Cline (VS Code): .cline/mcp.json im Workspace
• Continue: ~/.continue/config.json (Block mcpServers)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Nach der Bearbeitung den Client vollständig neu starten (Cmd+Q → erneut öffnen).

Überprüfung

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

Bitte den Client: “List 5 AstroWay tool names from astroway-hosted”. Es sollte Namen wie astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, … zurückgeben.

Rate Limits

Der gehostete Endpunkt ist durch eine 3-stufige Begrenzung geschützt: Cloudflare DDoS-Schicht + Edge-Proxy 120 req/min/IP + In-Memory-Bucket 60/60s/(IP+key). Echte MCP-Clients (Claude Desktop, Cursor) nähern sich diesen Limits nicht – sie führen keine Burst-Anfragen durch. Wenn deine Automatisierung / CI > 120 req/min benötigt – verwende den stdio-Modus (dort gibt es keine Limits, er geht direkt über api.astroway.info/v1/* mit deinem Tarif-Rate-Limit).

Was, wenn mcp.astroway.info vorübergehend nicht verfügbar ist

Wenn der gehostete Endpunkt 5xx zurückgibt, sieht der MCP-Client einen Fehler bei tools/list. Dies beeinflusst nicht Stdio-Clients – sie starten ein lokales npm-Paket, das direkt zu api.astroway.info/v1/* geht, ohne die zwischengeschaltete gehostete Schicht.

Fallback für kritische Integrationen: Füge einen zweiten MCP-Server in die Konfiguration mit Stdio-Modus ein – der Client wird ihn automatisch verwenden, wenn der gehostete Server nicht auf tools/list antwortet:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Die tatsächliche Uptime des gehosteten Endpunkts ist unter status.astroway.info sichtbar. Vorfälle > 5 Minuten werden innerhalb von 5 Werktagen als Postmortem veröffentlicht (gemäß /sla/).

Stdio (npm) – für die lokale Entwicklung

@astroway/mcp – ein npm-Paket, das lokal als Subprozess ausgeführt wird. Ein npm-Paket, native Integration mit Claude Desktop, Cursor und jedem MCP-kompatiblen Client.

So funktioniert es

Die Tool-Liste wird zum Zeitpunkt des Builds aus der Live-OpenAPI-Spezifikation (api.astroway.info/v1/openapi.json) generiert. Jedes Paket-Release übernimmt automatisch alle neuen Endpunkte – es muss nichts manuell gepflegt werden.

Jeder Endpunkt wird zu einem Tool des Typs:

• tools/list gibt die Beschreibung und das Eingabeschema (mit Beispiel-Anfragekörper) zurück
• tools/call führt einen HTTP POST an https://api.astroway.info/v1/<path> mit deinem ASTROWAY_API_KEY aus
• Die Antwort wird dem Agenten als strukturiertes JSON zurückgegeben

Jedes Release wird auch mit SLSA Provenance (Sigstore-attested) ausgeliefert – dies ist eine Garantie, dass das npm-Paket genau aus dem Commit im öffentlichen Repo erstellt wurde.

Installation

Claude Desktop (macOS)

Füge zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

Starte Claude Desktop neu. In der Leiste unter dem Chat erscheint ein 🛠️ Indikator mit der Anzahl der geladenen Tools.

Cursor

Füge zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

Derselbe npx @astroway/mcp Befehl funktioniert in jedem MCP-kompatiblen Client. Die Konfiguration ist identisch – nur der Dateipfad ändert sich:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Client	Pfad zur Konfiguration
Cline (VS Code)	.cline/mcp.json im Workspace-Stammverzeichnis
Continue	~/.continue/config.json (unter mcpServers)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	Preview-Flag → mcp.json im Workspace
VS Code MCP Extension	~/.vscode/mcp.json

Andere MCP-Clients

Starte als Stdio-Server:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Tipp

Schlüssel erhalten – unter api.astroway.info/dashboard/sign-up. Kostenloser Tarif – 10 000 Credits/Monat, ohne Kreditkarte.

Datenschutz – ab v1.0.0+

Dieser MCP-Server sendet nichts zurück an AstroWay, außer den API-Aufrufen, die du ihn ausführen lässt. Keine Telemetrie, keine Analysen, kein Opt-in/Opt-out-Schalter – standardmäßig Stille.

Ausgehende Anfragen tragen zwei Identifikations-Header, damit das AstroWay-Backend MCP-Traffic von direktem HTTP in seinen eigenen Logs unterscheiden kann:

• User-Agent: astroway-mcp/<version> (Node/<node-version>)
• X-Astroway-Channel: mcp

Keiner davon enthält eine Session-ID, einen Machine-Fingerprint oder irgendetwas Persönliches. Dies ist die Standard-User-Agent-Semantik – jedes CLI-Tool sendet ähnliche Informationen.

Subset-Registrierung – ab v1.0.0+

Wenn du nur einen Teil des Katalogs verwendest – registriere eine Untermenge, damit das Kontextfenster des LLM kompakt bleibt:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Gängige Gruppen: western, vedic, tarot, numerology, hd (Human Design), relational (Synastrie/Composite/Davison), prognostics (Transite/Progressionen/Returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Führe npx @astroway/mcp --list-tools aus, um die vollständige Liste zu sehen.

ASTROWAY_READONLY=1 überspringt drei Gruppen, die intern LLM aufrufen (ai, horoscope, reports) – nützlich, wenn du reine deterministische Kartenmathematik ohne Credit-Kosten für die Textgenerierung möchtest.

Stabilitätsverpflichtung – ab v1.0.0+

• Der Katalog ist für die Dauer der Sitzung eingefroren. Über 780 Tools, 12 Prompts, 14 Ressourcen sind zum Zeitpunkt des Builds in das veröffentlichte npm-Paket eingebettet – nichts ändert sich während der Verbindung. Wenn dein Client tools/list nach dem ersten Aufruf cached – bleibt er für die gesamte Sitzung korrekt.
• Tool-Identifikatoren sind innerhalb einer Hauptversion stabil. Ein Name unter astroway_<group>_<tool> wird innerhalb von v1.x nicht umbenannt oder gelöscht, ohne einen Deprecation-Hinweis in CHANGELOG.md und eine parallele Verfügbarkeit in einer Nebenversion.
• Die Tool-Eingabeform ist innerhalb einer Nebenversion stabil. Verschärfungen (Regex, Bereich, Enum) kommen in Patches; das Hinzufügen eines obligatorischen Feldes erfordert einen Minor-Bump.
• Katalog-Aktualisierung: durch Neuinstallation. npm i -g @astroway/mcp@latest (oder die npx -y @astroway/mcp-Form in deiner Konfiguration) ruft beim nächsten Start den aktuellen Satz ab.

Beispiel-Prompts

Nach dem Verbinden des Servers frage die KI:

Geburtshoroskop

Berechne mein Geburtshoroskop – geboren am 15. März 1990, 14:30 Uhr, Kiew. Beschreibe Sonne, Mond, Aszendent und finde enge Aspekte.

Claude ruft das chart-Tool mit deinen Parametern auf, erhält strukturiertes JSON und beschreibt das Horoskop in Worten.

Transite

Welche signifikanten Transite langsamer Planeten werden sich im Jahr 2027 auf mein Geburtshoroskop auswirken?

Claude führt zwei Tool-Aufrufe durch: zuerst transits (aktuelle Momentaufnahme), dann transit-calendar (Zeitraum). Interpretiert die Trends.

Vedische Mahadasha

Führe die Vimshottari Mahadasha für eine Person aus, die am 22.07.1985 um 06:45 Uhr in Mumbai geboren wurde. In welcher Periode befindet sich diese Person gerade?

Über das vedic/dashas/vimshottari/maha-Tool – der genaue UTC-Timestamp der aktuellen Periode.

Synastrie

Vergleiche zwei Horoskope: A – 10.06.1988 09:15 London, B – 22.11.1991 22:40 Berlin. Welches sind die stärksten Kreuz-Aspekte?

Das synastry-Tool mit zwei chart-Blöcken + Interpretation des Kompatibilitätsscores.

Tarot

Ziehe 3 Rider-Waite-Smith-Karten: Vergangenheit – Gegenwart – Zukunft. Frage: “Soll ich den neuen Job annehmen?”. Seed = 42.

tarot/rider-waite/spread mit festem Seed für Reproduzierbarkeit.

Liste aller Tools

Nach dem Verbinden frage Claude:

Liste alle AstroWay-Tools auf.

Oder über die Kommandozeile:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Konfiguration

Variable	Standard	Beschreibung	Ab Version
ASTROWAY_API_KEY	(erforderlich)	Live: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Override für selbst gehostete/Staging-Umgebungen.	0.1.0
ASTROWAY_TOOL_GROUPS	(alle Gruppen)	Komma-getrennte Präfixe zur Begrenzung des Katalogs (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 überspringt LLM-gestützte Gruppen (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug – Logging-Level für stderr.	0.8.0
LOG_FILE	(wird nicht geschrieben)	Pfad zur Datei für die Duplizierung von Logs.	0.8.0
MCP_FLAT_TOOLS	0	1 gibt Pre-v0.9 Flat-Namen zurück (chart statt astroway_western_chart). Legacy.	0.9.0

Warum MCP und nicht direkte Integration

Ein generisches LLM (ohne Grounding) würde sagen “irgendwann im Juli bildet Saturn ein Trigon zu deinem Jupiter” – ohne genaues Datum, mit ±15 Tagen Abweichung. Ein MCP-Agent führt tool_use POST /v1/transits aus und gibt einen UTC-Timestamp auf die Sekunde genau zurück, basierend auf dem echten Swiss Ephemeris.

Der Vorteil liegt nicht im LLM, sondern in der Garantie, dass die Mathematik real ist – nicht erfunden.

Paketverteilung

• 📦 mcp.so Listing: mcp.so/server/astroway-mcp/astroway
• 🌐 mcpservers.org: wartet auf Genehmigung (Stand Mai 2026)
• ⭐ awesome-mcp-servers (punkpeye): PR #5972

Links

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 API-Dokumentation: /docs/api/
• 🔑 Registrieren: /dashboard/sign-up
• 💰 Preise: /pricing/
• 🌐 Öffentliches Repo (MIT): github.com/astroway/astroway-mcp