Fügen Sie Astrologie zu Ihrem AI-Agenten über MCP hinzu

Wenn du in den letzten 12 Monaten mit Claude Desktop gearbeitet hast, hast du wahrscheinlich MCP (Model Context Protocol) gesehen. Dies ist ein offener Standard von Anthropic, um externe Tools mit AI-Modellen zu verbinden. Ein paar Konfigurationszeilen und Claude kann auf die Dateisysteme, Datenbanken oder jedes API zugreifen.

In diesem Beitrag wird gezeigt, wie du astrologische Berechnungen zu einem AI-Agenten über MCP hinzufügen kannst. Das dauert weniger als 5 Minuten.

MCP ist ein Protokoll, mit dem AI-Modelle Tools aufrufen. Stell dir vor, es ist wie ein «REST API für AI-Agents»:

• Server stellt Tools (Berechnungen, Anfragen, Aktionen) bereit
• Client (Claude Desktop, Cursor, benutzerdefinierter Agent) entdeckt und ruft sie auf
• Das Modell entscheidet selbst, wann welches Tool angewendet wird – basierend auf der Anfrage des Benutzers

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

Der MCP-Server AstroWay stellt 25 Tools bereit, die die grundlegenden astrologischen Berechnungen abdecken:

• natal_chart – vollständige Geburtshoroskopkarte
• synastry – Kompatibilität zwischen zwei Personen
• transits – aktuelle Transite auf die Geburtshoroskopkarte
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits – AI-Interpretationen
• human_design – vollständige HD-Karte
• hd_incarnation_cross, hd_compatibility – HD-Funktionen
• noch 12, die Fortschritte, Solar Returns, Astro-Kartografie und Rektifikation abdecken

Registriere dich auf astroway.info und erstelle einen kostenlosen API-Schlüssel (10 000 Credits/Monat, ohne Kreditkarte).

Datei claude_desktop_config.json:

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

Füge den AstroWay-Server hinzu:

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

Nach dem Neustart siehst du das Symbol eines Hammers mit 25 verfügbaren Tools.

Jetzt sprich einfach mit Claude in natürlicher Sprache:

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

Claude: Ruft natal_chart mit den geparsten Koordinaten auf, dann interpret_placement. Hier ist die Geburtshoroskopkarte. Die Sonne im Krebs im 10. Haus weist darauf hin…

Claude selbst:

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

Wenn du einen benutzerdefinierten AI-Agenten (nicht Claude Desktop) baust, kann der MCP-Server ebenfalls verwendet werden. 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 initialisieren
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

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

// Tool aufrufen
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 Frameworks für Agenten (LangChain, LlamaIndex usw.) haben eine integrierte Unterstützung für MCP.

Wenn du keine zusätzlichen Kosten für MCP haben möchtest – rufe 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();
}

// Verwendung im Agenten-Code
const chart = await callAstrowayTool('chart', birthData);

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

Wenn MCP eingerichtet ist, probiere es in Claude aus:

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

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

Die AI-Interpretations-Tools von AstroWay (interpret_*, *_horoscope) haben integrierte Sicherheitsmechanismen:

• Keine medizinischen, rechtlichen oder finanziellen Ratschläge
• Auto-eingefügte Disclaimers
• Inhaltsfilterung

Wenn der Agent den Text der Interpretation dem Benutzer zeigt – bewahre den Disclaimer. Er ist im Feld disclaimer jeder AI-Antwort.

MCP-Aufrufe gehen durch dasselbe Credit-System wie HTTP. Einfache Abfragen (10 Credits) → Chart (20) → Synastrie (50) → AI-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 Hunderten von Benutzern – berechne je nach Mix der Endpunkte. Daily-Horoscope-Bot für 1.000 Benutzer = 1.000 × 20 × 30 = 600.000 Credits/Monat → Pro-Plan.

• AstroWay MCP im npm
• AI-Agents und MCP – Use Case – vollständiger Integrationsleitfaden
• Horoskop- und AI-Interpretations-API – Produktseite
• Schnellstart – erhält einen API-Schlüssel (kostenlos, 10.000 Credits/Monat)