MCP - σύνδεση Claude / Cursor

Ο διακομιστής Model Context Protocol του AstroWay εκθέτει όλα τα 771 τελικά σημεία ως εργαλεία για τον πράκτορα AI. Δύο λειτουργίες – και οι δύο υποστηρίζονται εγγενώς από όλους τους συμβατούς με MCP πελάτες.

Λειτουργία	URL / εντολή	Πότε να επιλέξεις
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai στο πρόγραμμα περιήγησης), Claude Desktop / Cursor / Code newcomers χωρίς npm, ή όταν θέλεις μηδενική εγκατάσταση
Stdio (npm)	npx @astroway/mcp	Cursor power users, τοπική ανάπτυξη, ευαίσθητοι στην ιδιωτικότητα (το κλειδί δεν φεύγει ποτέ από τον υπολογιστή σου), έτοιμο για offline

Το φιλοξενούμενο τελικό σημείο και το πακέτο npm χρησιμοποιούν τον ίδιο κατάλογο εργαλείων (δημιουργείται από ένα /v1/openapi.json). Έλεγχος ταυτότητας: το ίδιο κλειδί API aw_test_* / aw_live_* – στο φιλοξενούμενο αποστέλλεται μέσω της κεφαλίδας Authorization: Bearer …, στο stdio μέσω της μεταβλητής περιβάλλοντος ASTROWAY_API_KEY.

Πηγή: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · φιλοξενούμενο: mcp.astroway.info/health

Φιλοξενούμενο (mcp.astroway.info) - μηδενική εγκατάσταση

Γρήγορη εκκίνηση χωρίς npm – επίλεξε τον πελάτη σου. Πριν την εγκατάσταση, πάρε ένα κλειδί από το api.astroway.info/dashboard/sign-up (10.000 πιστώσεις/μήνα δωρεάν).

Cursor (με ένα κλικ)

Πάτησε το κουμπί – το Cursor θα ανοίξει, θα ζητήσει επιβεβαίωση, θα προσθέσει την καταχώριση αυτόματα:

Εγκατάσταση στο Cursor →

Απαραίτητο 2ο βήμα - αλλιώς δεν θα λειτουργήσει

Το Cursor δεν μπορεί να εισάγει το μυστικό από το deeplink – στο ~/.cursor/mcp.json θα καταγραφεί το λεκτικό Bearer YOUR_API_KEY, στο οποίο ο διακομιστής απαντά 403 invalid_format.

Μετά το κλικ στο κουμπί:

1. Cursor Settings (⚙️ πάνω δεξιά γωνία) → Tools & MCP → βρες το astroway-hosted στη λίστα.
2. Πάτησε τις τρεις τελείες (⋯) δίπλα στον διακομιστή → Edit configuration.
3. Στο πεδίο Authorization αντικατάστησε το Bearer YOUR_API_KEY με το Bearer aw_test_… (ή aw_live_…) – το πραγματικό σου κλειδί από το Dashboard.
4. Αποθήκευσε → άνοιξε ξανά τη λίστα MCP → βεβαιώσου ότι η κατάσταση είναι enabled + πράσινη κουκκίδα + μετρητής 780+ tools enabled.

Εναλλακτικά – επεξεργάσου το αρχείο απευθείας: ~/.cursor/mcp.json (headers.Authorization).

Σημείωση

Το Cursor επιβάλλει όριο στο μήκος των ονομάτων: server_name:tool_name ≤ 60 χαρακτήρες. Περίπου 90 από τα 780+ εργαλεία (κυρίως οι ομάδες hellenistic_*, psychological_*, zi_wei_*, zodiac_* και numerology_*) φιλτράρονται από το Cursor και δεν θα είναι διαθέσιμα μέσω του LLM. Τα υπόλοιπα ~690 λειτουργούν. Στο Claude Desktop δεν υπάρχει τέτοιο όριο – πλήρης κατάλογος.

Claude Desktop

Settings → Developer → Edit Config ανοίγει το claude_desktop_config.json. Αυτό το αρχείο εκτελεί μόνο τοπικές εντολές: η καταχώριση με μόνο url παραλείπεται με το μήνυμα “Some MCP servers couldn’t be loaded”. Ο φιλοξενούμενος διακομιστής συνδέεται μέσω της γέφυρας mcp-remote, χρειάζεται Node.js:

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

Κλείσε εντελώς το Claude Desktop (Cmd+Q) και άνοιξέ το ξανά. Το κλειδί βρίσκεται στο env, επειδή το Claude Desktop στα Windows διασπά το όρισμα στο κενό μετά το Bearer.

Ο διάλογος Add custom connector στις Settings → Connectors δέχεται μόνο όνομα και URL, δεν υπάρχει πεδίο για την κεφαλίδα Authorization, οπότε το κλειδί AstroWay δεν μπορεί να μεταδοθεί μέσω αυτού προς το παρόν.

Διαμόρφωση JSON (μη αυτόματη)

Για Cursor, Cline, Continue και Windsurf, που δέχονται απευθείας απομακρυσμένο url:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Διαδρομές προς τις διαμορφώσεις:

• Cursor: ~/.cursor/mcp.json (καθολικά) ή .cursor/mcp.json (στον χώρο εργασίας)
• Cline (VS Code): .cline/mcp.json στον χώρο εργασίας
• Continue: ~/.continue/config.json (μπλοκ mcpServers)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Μετά την επεξεργασία, επανεκκίνησε πλήρως τον πελάτη (Cmd+Q → άνοιξε ξανά).

Έλεγχος

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

Στον πελάτη – ζήτησε: “List 5 AstroWay tool names from astroway-hosted”. Θα πρέπει να επιστρέψει ονόματα όπως astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Όρια ρυθμού

Το φιλοξενούμενο τελικό σημείο προστατεύεται από ένα όριο 3 επιπέδων: Cloudflare DDoS-layer + edge proxy 120 req/min/IP + in-memory bucket 60/60s/(IP+key). Οι πραγματικοί πελάτες MCP (Claude Desktop, Cursor) δεν πλησιάζουν αυτά τα όρια – δεν κάνουν burst-requests. Εάν η αυτοματοποίησή σου / CI απαιτεί > 120 req/min – χρησιμοποίησε τη λειτουργία stdio (εκεί δεν υπάρχουν όρια, πηγαίνει απευθείας μέσω api.astroway.info/v1/* με το όριο ρυθμού του τιμολογίου σου).

Τι γίνεται αν το mcp.astroway.info είναι προσωρινά μη διαθέσιμο

Εάν το φιλοξενούμενο τελικό σημείο επιστρέψει 5xx, ο πελάτης MCP θα δει ένα σφάλμα στο tools/list. Αυτό δεν επηρεάζει τους πελάτες stdio – αυτοί εκκινούν ένα τοπικό πακέτο npm, το οποίο πηγαίνει απευθείας στο api.astroway.info/v1/* χωρίς ενδιάμεσο φιλοξενούμενο επίπεδο.

Εφεδρική λύση για κρίσιμες ενσωματώσεις: πρόσθεσε έναν δεύτερο διακομιστή MCP στη διαμόρφωση με λειτουργία stdio – ο πελάτης θα τον χρησιμοποιήσει αυτόματα εάν ο φιλοξενούμενος δεν απαντήσει στο tools/list:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Η πραγματική διαθεσιμότητα του φιλοξενούμενου τελικού σημείου είναι ορατή στο status.astroway.info. Περιστατικά > 5 λεπτών δημοσιεύονται ως postmortem εντός 5 εργάσιμων ημερών (ανά /sla/).

Stdio (npm) - για τοπική ανάπτυξη

Το @astroway/mcp είναι ένα πακέτο npm που εκτελείται τοπικά ως υποδιεργασία. Ένα πακέτο npm, εγγενής ενσωμάτωση με Claude Desktop, Cursor και οποιονδήποτε συμβατό με MCP πελάτη.

Πώς λειτουργεί

Η λίστα εργαλείων δημιουργείται κατά τη στιγμή της κατασκευής από το ζωντανό OpenAPI-spec (api.astroway.info/v1/openapi.json). Κάθε έκδοση του πακέτου ενσωματώνει αυτόματα όλα τα νέα τελικά σημεία – δεν χρειάζεται χειροκίνητη συντήρηση.

Κάθε τελικό σημείο γίνεται ένα εργαλείο του τύπου:

• tools/list επιστρέφει την περιγραφή και το σχήμα εισόδου (με παράδειγμα σώματος αιτήματος)
• tools/call κάνει ένα HTTP POST στο https://api.astroway.info/v1/<path> με το ASTROWAY_API_KEY σου
• Η απάντηση επιστρέφεται στον πράκτορα ως δομημένο JSON

Κάθε έκδοση αποστέλλεται επίσης με SLSA provenance (Sigstore-attested) – αυτό εγγυάται ότι το πακέτο npm κατασκευάστηκε ακριβώς από το commit στο δημόσιο αποθετήριο.

Εγκατάσταση

Claude Desktop (macOS)

Πρόσθεσε στο ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

Επανεκκίνησε το Claude Desktop. Στη γραμμή κάτω από τη συνομιλία θα εμφανιστεί ένας δείκτης 🛠️ με τον αριθμό των φορτωμένων εργαλείων.

Cursor

Πρόσθεσε στο ~/.cursor/mcp.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

Η ίδια εντολή npx @astroway/mcp λειτουργεί σε κάθε συμβατό με MCP πελάτη. Η διαμόρφωση είναι πανομοιότυπη – αλλάζει μόνο η διαδρομή προς το αρχείο:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Πελάτης	Διαδρομή προς τη διαμόρφωση
Cline (VS Code)	.cline/mcp.json στη ρίζα του χώρου εργασίας
Continue	~/.continue/config.json (κάτω από mcpServers)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	preview-flag → mcp.json στον χώρο εργασίας
VS Code MCP extension	~/.vscode/mcp.json

Άλλοι πελάτες MCP

Εκτέλεσε ως διακομιστή stdio:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Συμβουλή

Για να λάβεις κλειδί – στο api.astroway.info/dashboard/sign-up. Δωρεάν βαθμίδα – 10 000 πιστώσεις/μήνα, χωρίς κάρτα.

Απόρρητο - από v1.0.0+

Αυτός ο διακομιστής MCP δεν στέλνει τίποτα πίσω στο AstroWay εκτός από τις ίδιες τις κλήσεις API που του δίνεις να εκτελέσει. Καμία τηλεμετρία, κανένα analytics, κανένας διακόπτης opt-in/opt-out – σιωπή από προεπιλογή.

Οι εξερχόμενες αιτήσεις φέρουν δύο κεφαλίδες αναγνώρισης ώστε το AstroWay backend να μπορεί να διακρίνει την κίνηση MCP από το άμεσο HTTP στα δικά του αρχεία καταγραφής:

• User-Agent: astroway-mcp/<version> (Node/<node-version>)
• X-Astroway-Channel: mcp

Καμία από αυτές δεν περιέχει αναγνωριστικό συνεδρίας, αποτύπωμα μηχανής ή οτιδήποτε προσωπικό. Αυτή είναι η τυπική σημασιολογία User-Agent – κάθε εργαλείο CLI στέλνει παρόμοιες πληροφορίες.

Καταχώριση υποσυνόλου - από v1.0.0+

Εάν χρησιμοποιείς μόνο ένα μέρος του καταλόγου – καταχώρισε ένα υποσύνολο ώστε το παράθυρο περιβάλλοντος του LLM να παραμείνει συμπαγές:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Κοινές ομάδες: western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Εκτέλεσε npx @astroway/mcp --list-tools για να δεις το πλήρες σύνολο.

Το ASTROWAY_READONLY=1 παραλείπει τρεις ομάδες που καλούν εσωτερικά το LLM (ai, horoscope, reports) – χρήσιμο όταν θέλεις καθαρά ντετερμινιστικά μαθηματικά χαρτών χωρίς να ξοδέψεις πιστώσεις για τη δημιουργία κειμένου.

Δέσμευση σταθερότητας - από v1.0.0+

• Ο κατάλογος είναι παγωμένος για τη διάρκεια της συνεδρίας. 780+ εργαλεία, 12 προτροπές, 14 πόροι ενσωματωμένοι στο δημοσιευμένο πακέτο npm κατά τη στιγμή της κατασκευής – τίποτα δεν αλλάζει κατά τη σύνδεση. Εάν ο πελάτης σου αποθηκεύει στην κρυφή μνήμη το tools/list μετά την πρώτη κλήση – παραμένει σωστό για όλη τη συνεδρία.
• Οι αναγνωριστικοί κωδικοί εργαλείων είναι σταθεροί εντός της κύριας έκδοσης. Το όνομα κάτω από astroway_<group>_<tool> δεν θα μετονομαστεί ή διαγραφεί εντός της v1.x χωρίς σημείωση απόσυρσης στο CHANGELOG.md και παράλληλη διαθεσιμότητα μιας δευτερεύουσας έκδοσης.
• Το σχήμα εισόδου εργαλείου είναι σταθερό εντός της δευτερεύουσας έκδοσης. Οι περιορισμοί (regex, range, enum) έρχονται σε patches. Η προσθήκη ενός υποχρεωτικού πεδίου απαιτεί μια δευτερεύουσα αύξηση έκδοσης.
• Ανανέωση καταλόγου: με επανεγκατάσταση. npm i -g @astroway/mcp@latest (ή η μορφή npx -y @astroway/mcp στη διαμόρφωσή σου) ανακτά το τρέχον σύνολο στην επόμενη εκκίνηση.

Παραδείγματα προτροπών

Μετά τη σύνδεση του διακομιστή, ζήτησε από το AI:

Γενέθλιος χάρτης

Υπολόγισε τον γενέθλιο χάρτη μου – γεννημένος στις 15 Μαρτίου 1990, 14:30, Κίεβο. Περίγραψε τον Ήλιο, τη Σελήνη, τον Ωροσκόπο και βρες τις στενές όψεις.

Ο Claude θα καλέσει το εργαλείο chart με τις παραμέτρους σου, θα λάβει δομημένο JSON και θα περιγράψει τον χάρτη με λόγια.

Διελεύσεις

Ποιες σημαντικές διελεύσεις αργών πλανητών θα επηρεάσουν τον γενέθλιο χάρτη μου κατά τη διάρκεια του 2027;

Ο Claude κάνει δύο κλήσεις εργαλείων: πρώτα transits (τρέχον στιγμιότυπο), μετά transit-calendar (εύρος). Ερμηνεύει τις τάσεις.

Βεδική Mahadasha

Εκτέλεσε Vimshottari Mahadasha για ένα άτομο που γεννήθηκε στις 22.07.1985 06:45 στη Βομβάη. Σε ποια περίοδο βρίσκεται αυτό το άτομο τώρα;

Μέσω του εργαλείου vedic/dashas/vimshottari/maha – ακριβής UTC-timestamp της τρέχουσας περιόδου.

Συναστρία

Σύγκρινε δύο χάρτες: Α - 10.06.1988 09:15 Λονδίνο, Β - 22.11.1991 22:40 Βερολίνο. Ποιες είναι οι ισχυρότερες διασταυρούμενες όψεις;

Εργαλείο synastry με δύο μπλοκ chart + ερμηνεία του σκορ συμβατότητας.

Ταρώ

Τράβηξε 3 κάρτες Rider-Waite-Smith: Παρελθόν - Παρόν - Μέλλον. Ερώτηση: “πρέπει να δεχτώ τη νέα δουλειά;”. Seed = 42.

tarot/rider-waite/spread με σταθερό seed για αναπαραγωγιμότητα.

Λίστα όλων των εργαλείων

Μετά τη σύνδεση, ρώτησε τον Claude:

Λίστα όλων των εργαλείων astroway.

Ή από τη γραμμή εντολών:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Διαμόρφωση

Μεταβλητή	Προεπιλογή	Περιγραφή	Από έκδοση
ASTROWAY_API_KEY	(απαραίτητο)	Live: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Αντικατάσταση για self-hosted/staging-περιβάλλοντα.	0.1.0
ASTROWAY_TOOL_GROUPS	(όλες οι ομάδες)	Comma-separated πρόθεμα για τον περιορισμό του καταλόγου (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 παραλείπει τις ομάδες που υποστηρίζονται από LLM (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug - επίπεδο καταγραφής στο stderr.	0.8.0
LOG_FILE	(δεν γράφεται)	Διαδρομή προς το αρχείο για διπλασιασμό των αρχείων καταγραφής.	0.8.0
MCP_FLAT_TOOLS	0	1 επιστρέφει pre-v0.9 flat-ονόματα (chart αντί για astroway_western_chart). Legacy.	0.9.0

Γιατί MCP, και όχι άμεση ενσωμάτωση

Ένα γενικό LLM (χωρίς grounding) θα πει “κάπου τον Ιούλιο ο Κρόνος θα σχηματίσει τρίγωνο με τον Δία σου” – χωρίς ακριβή ημερομηνία, με απόκλιση ±15 ημερών. Ένας πράκτορας MCP κάνει tool_use POST /v1/transits και επιστρέφει UTC-timestamp με ακρίβεια δευτερολέπτου, σε πραγματικό Swiss Ephemeris.

Το πλεονέκτημα δεν είναι στο LLM, αλλά στην εγγύηση ότι τα μαθηματικά είναι πραγματικά – όχι φανταστικά.

Διανομή πακέτου

• mcp.so listing: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: αναμένει έγκριση (από τον Μάιο του 2026)
• awesome-mcp-servers (punkpeye): PR #5972

Σύνδεσμοι

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 API docs: /docs/api/
• 🔑 Εγγραφή: /dashboard/sign-up
• 💰 Τιμολόγηση: /pricing/
• 🌐 Δημόσιο αποθετήριο (MIT): github.com/astroway/astroway-mcp