AstroWay/api v2.105.5 · el
όλες οι υπηρεσίες λειτουργούν κανονικά

Προσθέστε αστρολογία στο AI-πράκτορά σας μέσω MCP

Το Model Context Protocol (MCP) δίνει τη δυνατότητα στους AI-πράκτορες να καλούν εξωτερικά εργαλεία. Σε αυτόν τον οδηγό — πώς να προσθέσετε αστρολογικούς υπολογισμούς στο Claude, ChatGPT ή σε προσαρμοσμένους πράκτορες σε λιγότερο από 5 λεπτά.

Αν έχεις δουλέψει με το MCP (Model Context Protocol) του Claude Desktop τον τελευταίο χρόνο, πιθανότατα το έχεις δει. Πρόκειται για ένα ανοιχτό πρότυπο της Anthropic για τη σύνδεση εξωτερικών εργαλείων με μοντέλα AI. Με λίγες γραμμές διαμόρφωσης, το Claude μπορεί να αλληλεπιδρά με το σύστημα αρχείων, βάσεις δεδομένων ή οποιαδήποτε API.

Σε αυτήν την ανάρτηση, θα δούμε πώς να προσθέσεις αστρολογικούς υπολογισμούς στον AI πράκτορά σου μέσω του MCP. Θα χρειαστούν λιγότερο από 5 λεπτά.

Το MCP είναι ένα πρωτόκολλο μέσω του οποίου τα μοντέλα AI καλούν εργαλεία. Φαντάσου το σαν ένα «REST API για πράκτορες AI»:

  • Ο διακομιστής εκθέτει εργαλεία (υπολογισμούς, ερωτήματα, ενέργειες)
  • Ο πελάτης (Claude Desktop, Cursor, ένας custom πράκτορας) τα ανακαλύπτει και τα καλεί
  • Το ίδιο το μοντέλο αποφασίζει πότε να χρησιμοποιήσει ποιο εργαλείο — βάσει του αιτήματος του χρήστη

Οι διακομιστές MCP μπορεί να είναι τοπικοί (εκκίνηση ως υποδιεργασία) ή απομακρυσμένοι (HTTP). Οι περισσότεροι είναι τοπικοί — δημοσιεύονται στο npm και εκκινούνται μέσω npx.

Ο διακομιστής MCP του AstroWay εκθέτει 25 εργαλεία που καλύπτουν τους βασικούς αστρολογικούς υπολογισμούς:

  • natal_chart — πλήρης γενέθλιος χάρτης
  • synastry — συμβατότητα δύο ατόμων
  • transits — τρέχουσες μεταβάσεις στον γενέθλιο χάρτη
  • daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
  • interpret_natal, interpret_synastry, interpret_transits — AI ερμηνείες
  • human_design — πλήρης χάρτης Human Design
  • hd_incarnation_cross, hd_compatibility — χαρακτηριστικά Human Design
  • άλλα 12 που καλύπτουν προόδους, ηλιακές επιστροφές, αστροχαρτογραφία, ρυθμίσεις

Δημιούργησε έναν δωρεάν λογαριασμό στο astroway.info και δημιούργησε ένα δωρεάν κλειδί API (10.000 πιστώσεις/μήνα, χωρίς κάρτα).

Βήμα 2: Επεξεργάσου τη διαμόρφωση του Claude Desktop

Ενότητα με τίτλο «Βήμα 2: Επεξεργάσου τη διαμόρφωση του Claude Desktop»

Αρχείο claude_desktop_config.json:

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

Πρόσθεσε τον διακομιστή astroway:

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

Μετά την επανεκκίνηση, θα δεις ένα εικονίδιο σφυριού με τα 25 διαθέσιμα εργαλεία.

Τώρα μπορείς απλά να μιλάς στο Claude με φυσική γλώσσα:

Εσύ: Δημιούργησε έναν γενέθλιο χάρτη για κάποιον που γεννήθηκε στις 14 Ιουλίου 1990 στις 14:30 στην Κiev. Τι σημαίνει ο Ήλιος του στον Καρκίνο στον 10ο οίκο;

Claude: Καλεί το natal_chart με τις αναλυμένες συντεταγμένες, μετά το interpret_placement. Να ο γενέθλιος χάρτης. Ο Ήλιος στον Καρκίνο στον 10ο οίκο υποδεικνύει…

Το ίδιο το Claude:

  • αναλύει τη φυσική γλώσσα (πόλη → συντεταγμένες)
  • επιλέγει το σωστό εργαλείο
  • μορφοποιεί την απάντηση

Αν δημιουργείς έναν custom AI πράκτορα (όχι το Claude Desktop), μπορείς επίσης να χρησιμοποιήσεις τον διακομιστή MCP. Το πρωτόκολλο τεκμηριώνεται:

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
mcp.stdin.write(JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'initialize',
params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');
// Λίστα εργαλείων
mcp.stdin.write(JSON.stringify({
jsonrpc: '2.0',
id: 2,
method: 'tools/list',
}) + '\n');
// Κλήση εργαλείου
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');

Οι περισσότεροι frameworks για πράκτορες (LangChain, LlamaIndex κ.λπ.) έχουν ενσωματωμένη υποστήριξη για MCP.

Εναλλακτική λύση — απευθείας κλήση μέσω HTTP API

Ενότητα με τίτλο «Εναλλακτική λύση — απευθείας κλήση μέσω HTTP API»

Αν δεν θες το overhead του MCP, μπορείς να καλέσεις απευθείας το HTTP API από τον πράκτορά σου:

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();
}
// Χρήση στον βρόχο του πράκτορα
const chart = await callAstrowayTool('chart', birthData);

Πλεονεκτήματα του MCP: δομημένες περιγραφές εργαλείων, αυτόματη ανίχνευση, τυποποιημένη διαχείριση σφαλμάτων. Πλεονεκτήματα του HTTP: πιο απλό, λειτουργεί παντού, χωρίς υποδιεργασίες.

Όταν το MCP είναι ρυθμισμένο, δοκίμασε στο Claude:

  1. «Ποιός είναι ο ημερήσιος μου ωροσκόπος; Γεννήθηκα στις 3 Οκτωβρίου 1993 στις 6 το πρωί στη Νέα Υόρκη».
  2. «Υπολόγισε τον τύπο Human Design μου. Γεννήθηκα στις 22 Απριλίου 1987 στις 16:45 στο Λονδίνο».
  3. «Σύγκρινε τη συμβατότητα δύο ατόμων: εμένα (14 Ιουλίου 1990, Κίεβο) και τη σύντροφό μου (22 Μαρτίου 1992, Παρίσι)».
  4. «Ποιές είναι οι σημαντικότερες μεταβάσεις για εμένα σήμερα; Δώσε μου μια ερμηνεία».
  5. «Δεν ξέρω την ακριβή ώρα γέννησης. Τι δείχνει η ανάλυση ευαισθησίας για ένα εύρος ±30 λεπτών;»

Το ίδιο το Claude θα επιλέξει τα κατάλληλα εργαλεία, θα τα καλέσει αλληλουχικά και θα μορφοποιήσει την απάντηση με ανθρώπινη γλώσσα.

Τα εργαλεία AI ερμηνειών του AstroWay (interpret_*, *_horoscope) έχουν ενσωματωμένα συστήματα ασφαλείας:

  • Καμία ιατρική, νομική ή οικονομική συμβουλή
  • Αυτοματοποιημένες αποποιήσεις ευθυνών
  • Φιλτράρισμα περιεχομένου

Όταν ο πράκτορας εμφανίζει κείμενο ερμηνείας στον χρήστη — διατήρησε την αποποίηση ευθυνών. Αυτή βρίσκεται στο πεδίο disclaimer κάθε απάντησης AI.

Οι κλήσεις μέσω MCP περνούν από το ίδιο σύστημα πιστώσεων με το HTTP. Απλές αναζητήσεις (10 πιστώσεις) → χάρτης (20) → συναστρία (50) → AI ερμηνεία (50).

Για προσωπική χρήση (ένας χρήστης που κάνει ερωτήσεις στο Claude) — περίπου 200–500 πιστώσεις τον μήνα. Ο δωρεάν σχεδιάγραμμα έχει αρκετά.

Για έναν παραγωγικό πράκτορα με εκατοντάδες χρήστες — υπολόγισε ανάλογα με το μείγμα των endpoints. Ένας bot ημερήσιου ωροσκόπου για 1.000 χρήστες = 1.000 × 20 × 30 = 600.000 πιστώσεις/μήνα → σχέδιο Pro.

AstroWay team

Η μηχανική ομάδα του AstroWay API. Τυλίγουμε το Swiss Ephemeris σε καθαρό REST και γράφουμε για τις βαρετές λεπτομέρειες που όμως έχουν σημασία.

// δημιούργησε πάνω σε αυτό

Αυτή η ίδια Swiss Ephemeris που υπάρχει στο Solar Fire — σε 4 γραμμές κώδικα.

Δωρεάν κλειδί χωρίς κάρτα. 5.000 αιτήματα ανά μήνα μέχρι την πρώτη πληρωμή.

Περισσότερα από το blog όλες οι δημοσιεύσεις →

Engineering 2026-06-05

Natal Chart API in TypeScript: SDK + React Example

Compute a natal chart in TypeScript with the AstroWay SDK — typed responses, a React component, and where it beats a local ephemeris library.

Ephemeris 2026-06-05

How Accurate Is the Swiss Ephemeris? Verified Benchmarks

Swiss Ephemeris accuracy in numbers — planetary positions under 0.1 arcsecond, exact house cusps, eclipses within a minute — and how AstroWay verifies it.

Ephemeris 2026-06-05

Swiss Ephemeris: REST API vs pyswisseph (When to Use Which)

pyswisseph vs a REST API for Swiss Ephemeris calculations — C dependencies, data files, licensing and deployment compared, with a decision guide.