Füge Astrologie zu deinem AI-Agenten über MCP hinzu

MCP ist ein Protokoll, mit dem KI-Modelle Tools aufrufen. Stellen Sie es sich als “REST API für KI-Agenten” vor:

• Server stellen Tools (Berechnungen, Abfragen, Aktionen) bereit
• Client (Claude Desktop, Cursor, benutzerdefinierter Agent) entdeckt und ruft sie auf
• Das Modell selbst entscheidet, wann welches Tool verwendet werden soll: basierend auf der Benutzeranfrage

MCP-Server können lokal (als Unterprozess gestartet) oder remote (HTTP) sein. Die meisten lokalen Server werden bei npm veröffentlicht und über npx gestartet.

Der AstroWay MCP-Server stellt ein Tool für jede API-Operation bereit, 735 im npm-Paket und 843 auf dem gehosteten Server, mit Namen im Format astroway_<gruppe><operation>:

• astroway_western_chart und benachbarte Tools für Karten, Transite, Progressionen und Rückläufe
• astroway_relational_* für Synastrien, Komposit- und Gruppengrafiken
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: KI-Interpretationen
• Gruppen für Human Design, vedische, chinesische, hellenistische Astrologie, Tarot und Numerologie

Um die Liste zu verkürzen, verbinden Sie einen Domänenserver anstelle des vollständigen Katalogs, siehe MCP-Einstellungen

Registrieren Sie sich auf astroway.info und erstellen Sie einen kostenlosen API-Schlüssel (10 000 Credits/Monat, ohne Kreditkarte).

Die Datei claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie den AstroWay-Server hinzu:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Nach dem Neustart erscheinen die AstroWay-Tools im Tool-Menü im Chat-Eingabefeld.

Jetzt einfach mit Claude auf natürliche Sprache sprechen:

Du: Erstelle ein Geburtshoroskop für eine Person, geboren am 14. Juli 1990 um 14:30 Uhr in Kiew. Was bedeutet ihre Sonne im Krebs im 10. Haus?

Claude: Ruft natal_chart mit analysierten Koordinaten auf, dann interpret_placement. Hier ist das Geburtshoroskop. Die Sonne im Krebs im 10. Haus deutet darauf hin…

Claude selbst:

• analysiert natürliche Sprache (Stadt → Koordinaten)
• wählt das richtige Tool aus
• formatiert die Antwort

Wenn Sie einen benutzerdefinierten KI-Agenten (nicht Claude Desktop) erstellen, können Sie auch den MCP-Server verwenden. Das Protokoll ist dokumentiert:

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// MCP initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// List the tools
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Call a tool
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

Die meisten Agenten-Frameworks (LangChain, LlamaIndex usw.) haben eingebaute MCP-Unterstützung.

Wenn Sie die Overhead-Kosten von MCP vermeiden möchten, rufen Sie das HTTP-API direkt vom Agenten auf:

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

Vorteile von MCP: strukturierte Tool-Beschreibungen, automatische Erkennung, standardisierter Fehlerbehandlung. Vorteile von HTTP: einfacher, funktioniert überall, ohne Unterprozesse.

Wenn MCP eingerichtet ist, versuchen Sie es in Claude:

1. “Was ist mein tägliches Horoskop? Ich bin am 3. Oktober 1993 um 6 Uhr morgens in New York geboren”.
2. “Berechne meinen Human Design Typ. Geboren am 22. April 1987 um 16:45 Uhr in London”.
3. “Vergleiche die Kompatibilität zweier Personen: ich (14. Juli 1990, Kiew) und meine Freundin (22. März 1992, Paris)”.
4. “Was sind meine wichtigsten Transite heute? Gib eine Interpretation”.
5. “Ich kenne meine genaue Geburtszeit nicht. Was zeigt die Sensitivitätsanalyse für einen Bereich von ±30 Minuten?”

Claude wählt selbst die richtigen Tools, ruft sie koordiniert in einer Kette auf und formatiert die Antwort in menschlicher Sprache.

Die AstroWay KI-Interpretationstools (interpret_*, *_horoscope) haben eingebaute Sicherheitsvorkehrungen:

• Keine medizinischen, rechtlichen oder finanziellen Ratschläge
• Automatisch eingefügte Haftungsausschlüsse
• Inhaltsfilterung

Wenn der Agent dem Benutzer den Interpretationstext anzeigt - behalten Sie den Haftungsausschluss bei. Er befindet sich im Feld disclaimer jeder KI-Antwort.

MCP-Aufrufe verwenden das gleiche Credit-System wie HTTP. Einfache Abfragen (10 Credits) → Chart (20) → Synastrie (50) → KI-Interpretation (50).

Für den persönlichen Gebrauch (ein Benutzer, der Claude Fragen stellt) - etwa 200-500 Credits pro Monat. Der kostenlose Tarif reicht aus.

Für einen Produktions-Agenten mit hundert Benutzern - kalkulieren Sie je nach Mischung der Endpunkte. Ein Daily-Horoscope-Bot für 1.000 Benutzer = 1.000 × 20 × 30 = 600.000 Credits/Monat → Pro-Plan.

• AstroWay MCP bei npm
• KI-Agenten und MCP: Use Case: vollständiger Integrationsleitfaden
• Horoscope & AI Interpretations API: Produktseite
• Schnellstart: API-Schlüssel erhalten (kostenlos, 10.000 Credits/Monat)