Αν έχεις δουλέψει με το MCP (Model Context Protocol) του Claude Desktop τον τελευταίο χρόνο, πιθανότατα το έχεις δει. Πρόκειται για ένα ανοιχτό πρότυπο της Anthropic για τη σύνδεση εξωτερικών εργαλείων με μοντέλα AI. Με λίγες γραμμές διαμόρφωσης, το Claude μπορεί να αλληλεπιδρά με το σύστημα αρχείων, βάσεις δεδομένων ή οποιαδήποτε API.
Σε αυτήν την ανάρτηση, θα δούμε πώς να προσθέσεις αστρολογικούς υπολογισμούς στον AI πράκτορά σου μέσω του MCP. Θα χρειαστούν λιγότερο από 5 λεπτά.
Τι είναι το MCP
Ενότητα με τίτλο «Τι είναι το MCP»Το MCP είναι ένα πρωτόκολλο μέσω του οποίου τα μοντέλα AI καλούν εργαλεία. Φαντάσου το σαν ένα «REST API για πράκτορες AI»:
- Ο διακομιστής εκθέτει εργαλεία (υπολογισμούς, ερωτήματα, ενέργειες)
- Ο πελάτης (Claude Desktop, Cursor, ένας custom πράκτορας) τα ανακαλύπτει και τα καλεί
- Το ίδιο το μοντέλο αποφασίζει πότε να χρησιμοποιήσει ποιο εργαλείο — βάσει του αιτήματος του χρήστη
Οι διακομιστές MCP μπορεί να είναι τοπικοί (εκκίνηση ως υποδιεργασία) ή απομακρυσμένοι (HTTP). Οι περισσότεροι είναι τοπικοί — δημοσιεύονται στο npm και εκκινούνται μέσω npx.
Ο διακομιστής MCP του AstroWay
Ενότητα με τίτλο «Ο διακομιστής MCP του AstroWay»Ο διακομιστής MCP του AstroWay εκθέτει 25 εργαλεία που καλύπτουν τους βασικούς αστρολογικούς υπολογισμούς:
natal_chart— πλήρης γενέθλιος χάρτηςsynastry— συμβατότητα δύο ατόμωνtransits— τρέχουσες μεταβάσεις στον γενέθλιο χάρτηdaily_horoscope,weekly_horoscope,monthly_horoscope,yearly_horoscopeinterpret_natal,interpret_synastry,interpret_transits— AI ερμηνείεςhuman_design— πλήρης χάρτης Human Designhd_incarnation_cross,hd_compatibility— χαρακτηριστικά Human Design- άλλα 12 που καλύπτουν προόδους, ηλιακές επιστροφές, αστροχαρτογραφία, ρυθμίσεις
Ρύθμιση για το Claude Desktop
Ενότητα με τίτλο «Ρύθμιση για το Claude Desktop»Βήμα 1: Απόκτησε ένα κλειδί API
Ενότητα με τίτλο «Βήμα 1: Απόκτησε ένα κλειδί API»Δημιούργησε έναν δωρεάν λογαριασμό στο 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" } } }}Βήμα 3: Επανεκκίνησε το Claude Desktop
Ενότητα με τίτλο «Βήμα 3: Επανεκκίνησε το Claude Desktop»Μετά την επανεκκίνηση, θα δεις ένα εικονίδιο σφυριού με τα 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'],});
// Αρχικοποίηση MCPmcp.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:
- «Ποιός είναι ο ημερήσιος μου ωροσκόπος; Γεννήθηκα στις 3 Οκτωβρίου 1993 στις 6 το πρωί στη Νέα Υόρκη».
- «Υπολόγισε τον τύπο Human Design μου. Γεννήθηκα στις 22 Απριλίου 1987 στις 16:45 στο Λονδίνο».
- «Σύγκρινε τη συμβατότητα δύο ατόμων: εμένα (14 Ιουλίου 1990, Κίεβο) και τη σύντροφό μου (22 Μαρτίου 1992, Παρίσι)».
- «Ποιές είναι οι σημαντικότερες μεταβάσεις για εμένα σήμερα; Δώσε μου μια ερμηνεία».
- «Δεν ξέρω την ακριβή ώρα γέννησης. Τι δείχνει η ανάλυση ευαισθησίας για ένα εύρος ±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 MCP στο npm
- AI πράκτορες και MCP — οδηγός περιπτώσεων χρήσης — πλήρης οδηγός ολοκλήρωσης
- API ωροσκόπων & AI ερμηνειών — σελίδα προϊόντος
- Γρήγορη εκκίνηση — απόκτησε κλειδί API (δωρεάν, 10.000 πιστώσεις/μήνα)
Αυτή η ίδια Swiss Ephemeris που υπάρχει στο Solar Fire — σε 4 γραμμές κώδικα.
Δωρεάν κλειδί χωρίς κάρτα. 5.000 αιτήματα ανά μήνα μέχρι την πρώτη πληρωμή.