Αν δούλευες με το Claude Desktop το τελευταίο έτος - σίγουρα έχεις δει το MCP (Model Context Protocol). Αυτό είναι ένα ανοιχτό πρότυπο της Anthropic για τη σύνδεση εξωτερικών εργαλείων σε μοντέλα AI. Με μερικές γραμμές ρυθμίσεων - το Claude μπορεί να επικοινωνεί με το σύστημα αρχείων, βάσεις δεδομένων ή οποιοδήποτε API.
Σε αυτό το άρθρο - πώς να προσθέσεις αστρολογικούς υπολογισμούς σε έναν πράκτορα AI μέσω MCP. Χρόνος - λιγότερο από 5 λεπτά.
Τι είναι το MCP
Ενότητα με τίτλο «Τι είναι το MCP»Το MCP είναι ένα πρωτόκολλο με τα οποία τα μοντέλα AI καλούν εργαλεία. Φαντάσου το σαν “REST API για πράκτορες AI”:
- Εξυπηρετητής (server) προσφέρει εργαλεία (υπολογισμοί, ερωτήματα, ενέργειες)
- Πελάτης (client) (Claude Desktop, Cursor, προσαρμοσμένος πράκτορας) τα εντοπίζει και τα καλεί
- Το μοντέλο από μόνο του αποφασίζει πότε θα εφαρμόσει ποιο εργαλείο: με βάση το αίτημα του χρήστη
Οι εξυπηρετητές MCP μπορεί να είναι τοπικοί (εκτέλεση ως υποδιεργασία) ή απομακρυσμένοι (HTTP). Οι περισσότεροι τοπικοί - δημοσιεύονται στο npm και εκτελούνται μέσω npx.
Διακομιστής MCP AstroWay
Ενότητα με τίτλο «Διακομιστής MCP AstroWay»Ο διακομιστής MCP AstroWay προσφέρει ένα εργαλείο ανά λειτουργία API, 735 στο πακέτο npm και 843 στον φιλοξενούμενο διακομιστή, με ονόματα της μορφής astroway_<ομάλα_<λειτουργία>:
astroway_western_chartκαι γειτονικά εργαλεία για χάρτες, διελεύσεις, προόδους και επιστροφέςastroway_relational_*για συναστρία, σύνθετο και ομαδικούς χάρτεςastroway_ai_interpret_natal,astroway_ai_interpret_synastry: AI ερμηνείες- ομάδες Human Design, Βεδικής, Κινεζικής, Ελληνιστικής αστρολογίας, ταρώ και αριθμολογίας
Για να μειώσεις τη λίστα, συνδέ έναν διακομιστή ανά τομέα αντί για ολόκληρο τον κατάλογο, δες Ρυθμίσεις MCP
Ρύθμιση για 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»Μετά την επανεκκίνηση, τα εργαλεία 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 initializemcp.stdin.write(JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05', capabilities: {} },}) + '\n');
// List the toolsmcp.stdin.write(JSON.stringify({ jsonrpc: '2.0', id: 2, method: 'tools/list',}) + '\n');
// Call a toolmcp.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.
Εναλλακτική: άμεσο HTTP-API
Ενότητα με τίτλο «Εναλλακτική: άμεσο HTTP-API»Αν δεν θέλεις το επιπλέον κόστος 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 loopconst chart = await callAstrowayTool('chart', birthData);Πλεονεκτήματα MCP: δομημένες περιγραφές εργαλείων, αυτόματη ανίχνευση, τυποποιημένη διαχείριση σφαλμάτων. Πλεονεκτήματα HTTP: απλούστερο, λειτουργεί οπουδήποτε, χωρίς υποδιεργασίες.
Παραδείγματα προτροπών
Ενότητα με τίτλο «Παραδείγματα προτροπών»Όταν το MCP είναι ρυθμισμένο, δοκίμασε στο Claude:
- “Ποιος είναι ο ημερήσιος αστρολογικός μου προφήθειας; Γεννήθηκα στις 3 Οκτωβρίου 1993 στις 6 το πρωί στη Νέα Υόρκη”.
- “Υπολόγισε τον τύπο Human Design μου. Γεννήθηκα στις 22 Απριλίου 1987 στις 16:45 στο Λονδίνο”.
- “Σύγκρινες τη συμβατότητα δύο ανθρώπων: εγώ (14 Ιουλίου 1990, Κίεβο) και η φίλη μου (22 Μαρτίου 1992, Παρίσι)”.
- “Ποιοι είναι οι κύριοι διελεύσεις για μέση σήμερα; Δώσε μου μια ερμηνεία”.
- “Δεν γνωρίζω την ακριβή ώρα γέννησης. Τι δείχνει η ανάλυση ευαισθησίας για ένα εύρος ±30 λεπτών;”
Το από μόνος του Claude θα επιλέξει τα κατάλληλα εργαλεία, θα καλέσει συντονισμένα πολλαπλά σε μια αλυσίδα και θα μορφοποιήσει την απάντηση με ανθρώπινη γλώσσα.
Ασφάλεια και disclaimer
Ενότητα με τίτλο «Ασφάλεια και disclaimer»Τα εργαλεία 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.
Τι θα ακολουθήσει
Ενότητα με τίτλο «Τι θα ακολουθήσει»- AstroWay MCP στο npm
- AI πράκτορες και MCP: use case: πλήρες οδηγός ενσωμάτωσης
- Horoscope & AI Interpretations API: σελίδα προϊόντος
- Γρήγορη εκκίνηση: πάρε το κλειδί API (δωρεάν, 10.000 πιστώσεις/μήνα)
Θέσεις με ακρίβεια δευτερολέπτου τόξου σε 4 γραμμές κώδικα.
Δωρεάν κλειδί χωρίς κάρτα. 5.000 αιτήματα ανά μήνα μέχρι την πρώτη πληρωμή.