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

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

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

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

Σε αυτό το άρθρο - πώς να προσθέσεις αστρολογικούς υπολογισμούς σε έναν πράκτορα AI μέσω MCP. Χρόνος - λιγότερο από 5 λεπτά.

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

  • Εξυπηρετητής (server) προσφέρει εργαλεία (υπολογισμοί, ερωτήματα, ενέργειες)
  • Πελάτης (client) (Claude Desktop, Cursor, προσαρμοσμένος πράκτορας) τα εντοπίζει και τα καλεί
  • Το μοντέλο από μόνο του αποφασίζει πότε θα εφαρμόσει ποιο εργαλείο: με βάση το αίτημα του χρήστη

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

Ο διακομιστής MCP AstroWay προσφέρει ένα εργαλείο ανά λειτουργία API, 735 στο πακέτο npm και 843 στον φιλοξενούμενο διακομιστή, με ονόματα της μορφής astroway_<ομάλα_<λειτουργία>:

  • astroway_western_chart και γειτονικά εργαλεία για χάρτες, διελεύσεις, προόδους και επιστροφές
  • astroway_relational_* για συναστρία, σύνθετο και ομαδικούς χάρτες
  • astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI ερμηνείες
  • ομάδες Human Design, Βεδικής, Κινεζικής, Ελληνιστικής αστρολογίας, ταρώ και αριθμολογίας

Για να μειώσεις τη λίστα, συνδέ έναν διακομιστή ανά τομέα αντί για ολόκληρο τον κατάλογο, δες Ρυθμίσεις MCP

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

Το αρχείο 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"
}
}
}
}

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

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

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

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

Το από μόνος του Claude:

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

Αν χτίζεις έναν προσαρμοσμένο πράκτορα 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 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');

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

Αν δεν θέλεις το επιπλέον κόστος 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();
}
// Use in your agent loop
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) έχουν ενσωματωμένα safety-guardrails:

  • Κανένα ιατρικό, νομικό ή οικονομικό συμβουλευτικό
  • Auto-injected disclaimer
  • Φιλτράρισμα περιεχομένου

Όταν ο πράκτορας εμφανίζει το κείμενο της ερμηνείας στον χρήστη - διατήρησε το disclaimer. Βρίσκεται στο πεδίο disclaimer κάθε AI απάντησης.

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

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

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

MakSeong · AstroWay

Δημιουργώ το AstroWay API: τυλίγω αστρολογικά μαθηματικά ακρίβειας δευτερολέπτου τόξου σε καθαρό REST και γράφω για τις βαρετές λεπτομέρειες που είναι πραγματικά σημαντικές.

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

Θέσεις με ακρίβεια δευτερολέπτου τόξου σε 4 γραμμές κώδικα.

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

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

Ephemeris 2026-07-19

Πώς διατηρούμε την ακρίβεια υπό έλεγχο: CI εναντίον swetest και NASA

Η ακρίβεια στο astro-API υποβαθμίζεται εύκολα από μια μόνο ανασυγκρότηση των εφεμερίδων. Αναλύουμε την προστασία: ένας πυρήνας Swiss Ephemeris για την εφαρμογή και το API, εκατοντάδες παγωμένα snapshots σε πρότυπους χάρτες και τριγωνοποίηση κάθε PR εναντίον swetest CGI, Kerykeion, Prokerala και του καταλόγου σκιών της NASA.

Engineering 2026-07-15

Τρία επίσημα SDK: TypeScript, Python, PHP αντί για ακατέργαστο curl

Ακατέργαστο HTTP λειτουργεί, αλλά ο τυποποιημένος πελάτης εξοικονομεί ώρες: αυτόματη συμπλήρωση διαδρομών, τύποι αιτήματος και απάντησης, ενσωματωμένο retry σε 408/409/429/5xx και ιεραρχία σφαλμάτων τύπου Stainless. Αναλύουμε τρία επίσημα SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - και πώς δημιουργήθηκαν από ένα OpenAPI συμβόλαιο.

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.