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 नए उपयोगकर्ता बिना npm के, या जब तू zero‑install चाहता है
Stdio (npm)	npx @astroway/mcp	Cursor पावर यूज़र्स, लोकल डेवलपमेंट, प्राइवेसी‑कंसियस (की कभी भी तेरी मशीन नहीं छोड़ती), ऑफ़लाइन‑रेडी

Hosted endpoint और npm‑पैकेज वही टूल‑कैटलॉग उपयोग करते हैं (एक /v1/openapi.json से जेनरेट होता है)। Auth: समान aw_test_* / aw_live_* API‑की - hosted में Authorization: Bearer … हेडर के ज़रिए भेजा जाता है, stdio में - ASTROWAY_API_KEY env var के ज़रिए।

स्रोत: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · hosted: mcp.astroway.info/health

Hosted (mcp.astroway.info) - ज़ीरो इंस्टॉल

तेज़ स्टार्ट बिना npm के - अपना क्लाइंट चुन। इंस्टॉल करने से पहले api.astroway.info/dashboard/sign-up से की ले (10 000 क्रेडिट/माह मुफ्त)।

Cursor (one-click)

बटन दबा - Cursor खुलेगा, पुष्टि करने को कहेगा, रिकॉर्ड ऑटोमैटिकली जोड़ देगा:

Cursor में इंस्टॉल →

अनिवार्य दूसरा कदम - नहीं तो काम नहीं करेगा

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” संदेश के साथ स्किप हो जाता है। Hosted‑सर्वर 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 में रखी होती है, क्योंकि Windows पर Claude Desktop Bearer के बाद स्पेस पर आर्ग्यूमेंट को विभाजित करता है।

Settings → Connectors में Add custom connector डायलॉग केवल नाम और URL लेता है, इसमें Authorization हेडर फ़ील्ड नहीं है, इसलिए AstroWay की अभी इसके ज़रिए पास नहीं की जा सकती।

JSON config (manual)

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 आदि नाम लौटाएगा।

रेट लिमिट्स

Hosted endpoint 3‑लेयर प्रोटेक्शन से सुरक्षित है: Cloudflare DDoS‑लेयर + edge proxy 120 req/min/IP + इन‑मेमोरी बकेट 60/60s/(IP+key)। वास्तविक MCP‑क्लाइंट्स (Claude Desktop, Cursor) इन लिमिट्स के करीब नहीं आते - वे बर्स्ट‑रिक्वेस्ट नहीं करते। अगर तेरी ऑटोमेशन / CI को > 120 req/min चाहिए - stdio मोड इस्तेमाल कर (वहाँ कोई लिमिट नहीं, सीधे api.astroway.info/v1/* पर तेरे रेट‑लिमिट के साथ जाता है)।

अगर mcp.astroway.info अस्थायी रूप से उपलब्ध नहीं है

अगर hosted endpoint 5xx रिटर्न करता है, MCP‑क्लाइंट tools/list पर एरर देखेगा। यह std​io‑क्लाइंट्स को नहीं प्रभावित करता - वे लोकल npm‑पैकेज चलाते हैं, जो सीधे api.astroway.info/v1/* पर जाता है बिना मध्यवर्ती hosted‑लेयर के।

क्रिटिकल इंटीग्रेशन के लिए फॉलबैक: stdio‑मोड के साथ कॉन्फ़िग में दूसरा MCP‑सर्वर जोड़ - क्लाइंट स्वचालित रूप से उसे उपयोग करेगा अगर hosted 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_..." }
    }
  }
}

Hosted endpoint का वास्तविक अपटाइम status.astroway.info पर देखा जा सकता है। 5 मिनट से अधिक के इन्सिडेंट्स को पोस्टमॉर्टेम के रूप में 5 कार्य दिवसों के भीतर प्रकाशित किया जाता है (per /sla/)।

Stdio (npm) - लोकल डेवलपमेंट के लिए

@astroway/mcp - npm‑पैकेज जो लोकली subprocess के रूप में चलता है। एक npm‑पैकेज, Claude Desktop, Cursor और किसी भी MCP‑संगत क्लाइंट के साथ नेटिव इंटीग्रेशन।

यह कैसे काम करता है

Tool लिस्ट बिल्ड के समय लाइव OpenAPI‑spec (api.astroway.info/v1/openapi.json) से जेनरेट होती है। पैकेज का हर रिलीज़ स्वचालित रूप से सभी नए एंडपॉइंट्स को शामिल करता है - मैन्युअली कुछ भी सपोर्ट करने की जरूरत नहीं।

हर एंडपॉइंट टूल बन जाता है इस प्रकार:

• tools/list विवरण और इनपुट स्कीमा (रिक्वेस्ट बॉडी का उदाहरण) लौटाता है
• tools/call https://api.astroway.info/v1/<path> पर HTTP POST करता है आपके ASTROWAY_API_KEY के साथ
• रिस्पॉन्स एजेंट को structured JSON के रूप में मिलता है

हर रिलीज़ SLSA provenance (Sigstore-attested) के साथ शिप होता है - यह गारंटी देता है कि npm‑पैकेज पब्लिक रेपो के कमिट से बिल्ट है।

इंस्टॉलेशन

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 workspace की रूट में
Continue	~/.continue/config.json (mcpServers के तहत)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	preview‑फ़्लैग → mcp.json workspace में
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‑कॉल्स के जो तू उसे करने देता है। कोई टेलीमेट्री, कोई एनालिटिक्स, कोई opt‑in/opt‑out स्विच नहीं - डिफ़ॉल्ट रूप से चुप।

आउटगोइंग रिक्वेस्ट दो पहचान हेडर ले जाते हैं ताकि AstroWay बैकएंड MCP‑ट्रैफ़िक को सीधे HTTP से अलग कर सके अपने लॉग्स में:

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

इनमें से कोई भी session ID, मशीन फ़िंगरप्रिंट या कोई पर्सनल डेटा नहीं रखता। यह स्टैंडर्ड 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 को कैश करता है - वह पूरी सत्र के लिए सही रहेगा।
• Tool identifiers मेजर वर्ज़न के भीतर स्थिर। astroway_<group>_<tool> नाम v1.x के अंदर बिना deprecation नोट CHANGELOG.md में और एक‑माइनर समान उपलब्धता के नहीं बदलेगा या हटाया नहीं जाएगा।
• Tool input shape माइनर वर्ज़न के भीतर स्थिर। वैधता (regex, range, enum) पैच में आती है; एक आवश्यक फ़ील्ड जोड़ने के लिए माइनर बम्प चाहिए।
• कैटलॉग रीफ़्रेश: री‑इंस्टॉल से। npm i -g @astroway/mcp@latest (या npx -y @astroway/mcp तेरे कॉन्फ़िग में) अगले स्टार्ट पर वर्तमान सेट लाता है।

प्रॉम्प्ट उदाहरण

सर्वर कनेक्ट करने के बाद AI से पूछ:

जन्म कुंडली

मेरी जन्म कुंडली निकाल - जन्म 15 मार्च 1990, 14:30, Киев। सूरज, चंद्र, असेंडेंट का वर्णन करो और निकटतम एस्पेक्ट्स ढूँढो।

ट्रांज़िट्स

2027 में मेरी जन्म कुंडली पर धीमी ग्रहों के कौन से महत्वपूर्ण ट्रांज़िट्स पड़ेंगे?

Claude दो tool‑call करता है: पहले transits (वर्तमान स्नैपशॉट), फिर transit-calendar (रेंज)। ट्रेंड्स की व्याख्या करता है।

वैदिक महादशा

22.07.1985 06:45 मुंबई में जन्मे व्यक्ति के लिए Vimshottari Mahadasha चलाओ। वह वर्तमान में किस अवधि में है?

vedic/dashas/vimshottari/maha टूल के ज़रिए - वर्तमान अवधि का सटीक UTC‑timestamp।

सिनास्ट्रि

दो कुंडलियों की तुलना करो: A - 10.06.1988 09:15 लंदन, B - 22.11.1991 22:40 बर्लिन। सबसे मजबूत क्रॉस‑एस्पेक्ट्स कौन से हैं?

synastry टूल दो chart ब्लॉक्स के साथ + संगतता स्कोर की व्याख्या।

टैरो

Rider‑Waite‑Smith से 3 कार्ड निकाल: अतीत - वर्तमान - भविष्य। प्रश्न: “क्या नई नौकरी लेनी चाहिए?”। 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)

कॉन्फ़िगरेशन

Variable	Default	Description	Since version
ASTROWAY_API_KEY	(required)	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	(all groups)	कैटलॉग को सीमित करने के लिए कॉमा‑सेपरेटेड प्रीफ़िक्स (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	(not written)	फ़ाइल पाथ लॉग डुप्लिकेशन के लिए।	0.8.0
MCP_FLAT_TOOLS	0	1 pre‑v0.9 फ्लैट‑नाम लौटाता है (chart बजाय astroway_western_chart)। Legacy.	0.9.0

क्यों MCP, न कि सीधे इंटीग्रेशन

जनरल LLM (बिना ग्राउंडिंग) कहेगा “किसी जुलाई में सैटर्न तुम्हारे बृहस्पति के साथ ट्राइगन बनाएगा” - बिना सटीक तारीख के, ±15 दिन की ड्रिफ्ट के साथ। MCP‑एजेंट tool_use POST /v1/transits करता है और UTC‑timestamp सेकंड तक रिटर्न करता है, असली Swiss Ephemeris पर।

फायदा LLM में नहीं, बल्कि इस गारंटी में है कि गणित वास्तविक है - न कि बनावटी।

पैकेज वितरण

• mcp.so listing: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: approval की प्रतीक्षा (मई 2026 तक)
• awesome-mcp-servers (punkpeye): PR #5972

लिंक

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 API docs: /docs/api/
• 🔑 Sign up: /dashboard/sign-up
• 💰 Pricing: /pricing/
• 🌐 Public repo (MIT): github.com/astroway/astroway-mcp