MCP - připojení Claude / Cursor

Server AstroWay Model Context Protocol zpřístupňuje všech 771 endpointů jako nástroje pro AI agenta. Dva režimy – oba jsou nativně podporovány všemi klienty kompatibilními s MCP.

Režim	URL / příkaz	Kdy zvolit
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai v prohlížeči), Claude Desktop / Cursor / Code newcomers bez npm, nebo když chceš zero-install
Stdio (npm)	npx @astroway/mcp	Cursor power users, lokální vývoj, privacy-conscious (klíč nikdy neopustí tvůj počítač), offline-ready

Hosted endpoint a npm balíček používají stejný katalog nástrojů (generovaný z jednoho /v1/openapi.json). Auth: stejný aw_test_* / aw_live_* API klíč – u hosted se posílá přes Authorization: Bearer … header, u stdio přes ASTROWAY_API_KEY env var.

Source: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · hosted: mcp.astroway.info/health

Hosted (mcp.astroway.info) – nulová instalace

Rychlý start bez npm – vyber si svého klienta. Před instalací si vezmi klíč na api.astroway.info/dashboard/sign-up (10 000 kreditů/měsíc zdarma).

Cursor (one-click)

Klikni na tlačítko – Cursor se otevře, požádá o potvrzení a automaticky přidá záznam:

Nainstalovat do Cursoru →

Povinný 2. krok – jinak nebude fungovat

Cursor neumí vložit tajemství z deeplinku – do ~/.cursor/mcp.json se zapíše literál Bearer YOUR_API_KEY, na který server odpoví 403 invalid_format.

Po kliknutí na tlačítko:

1. Cursor Settings (⚙️ pravý horní roh) → Tools & MCP → najdi astroway-hosted v seznamu.
2. Klikni na tři tečky (⋯) vedle serveru → Edit configuration.
3. V poli Authorization nahraď Bearer YOUR_API_KEY za Bearer aw_test_… (nebo aw_live_…) – tvůj skutečný klíč z Dashboardu.
4. Ulož → znovu otevři seznam MCP → ujisti se, že status je enabled + zelená tečka + počítadlo 780+ tools enabled.

Alternativně – uprav soubor přímo: ~/.cursor/mcp.json (headers.Authorization).

Poznámka

Cursor ukládá limit na délku jmen: server_name:tool_name ≤ 60 znaků. Přibližně 90 z 780+ nástrojů (většinou skupiny hellenistic_*, psychological_*, zi_wei_*, zodiac_* a numerology_*) je filtrováno Cursorem a nebude dostupných přes LLM. Ostatních ~690 funguje. V Claude Desktop takový limit není – plný katalog.

Claude Desktop

Settings → Developer → Edit Config otevře claude_desktop_config.json. Tento soubor spouští pouze lokální příkazy: záznam se samotným url je přeskočen se zprávou “Some MCP servers couldn’t be loaded”. Hosted server se připojuje přes most mcp-remote, potřebuje 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_..." }
    }
  }
}

Úplně zavři Claude Desktop (Cmd+Q) a znovu otevři. Klíč je v env, protože Claude Desktop na Windows rozdělí argument na mezeře po Bearer.

Dialog Add custom connector v Settings → Connectors přijímá pouze název a URL, pole pro hlavičku Authorization v něm není, takže klíč AstroWay přes něj nyní nelze předat.

JSON config (manual)

Pro Cursor, Cline, Continue a Windsurf, které přijímají vzdálený url přímo:

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

Cesty ke konfiguracím:

• Cursor: ~/.cursor/mcp.json (globálně) nebo .cursor/mcp.json (ve workspace)
• Cline (VS Code): .cline/mcp.json v kořeni workspace
• Continue: ~/.continue/config.json (blok mcpServers)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Po úpravě úplně restartuj klienta (Cmd+Q → znovu otevřít).

Ověření

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

V klientovi – požádej: “List 5 AstroWay tool names from astroway-hosted”. Mělo by vrátit jména typu astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Rate limity

Hosted endpoint je chráněn 3úrovňovým omezením: Cloudflare DDoS vrstva + edge proxy 120 req/min/IP + in-memory bucket 60/60s/(IP+key). Skuteční MCP klienti (Claude Desktop, Cursor) se k těmto limitům nepřibližují – nedělají burst požadavky. Pokud tvá automatizace / CI potřebuje > 120 req/min – použij stdio režim (tam limity nejsou, jde přímo přes api.astroway.info/v1/* s tvým tarifním rate-limitem).

Co když je mcp.astroway.info dočasně nedostupný

Pokud hosted endpoint vrátí 5xx, MCP klient uvidí chybu při tools/list. To neovlivňuje stdio klienty – ti spouštějí lokální npm balíček, který jde přímo na api.astroway.info/v1/* bez mezilehlé hosted vrstvy.

Fallback pro kritické integrace: přidej druhý MCP server do konfigurace s stdio režimem – klient ho automaticky použije, pokud hosted neodpoví na 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_..." }
    }
  }
}

Skutečný uptime hosted endpointu je vidět na status.astroway.info. Incidenty > 5 minut zveřejňujeme jako postmortem do 5 pracovních dnů (dle /sla/).

Stdio (npm) – pro lokální vývoj

@astroway/mcp – npm balíček, který se spouští lokálně jako subprocess. Jeden npm balíček, nativní integrace s Claude Desktop, Cursor a jakýmkoli klientem kompatibilním s MCP.

Jak to funguje

Seznam nástrojů se generuje v době buildu z live OpenAPI specifikace (api.astroway.info/v1/openapi.json). Každé vydání balíčku automaticky převezme všechny nové endpointy – nic není třeba ručně udržovat.

Každý endpoint se stane nástrojem typu:

• tools/list vrátí popis a schéma vstupu (s příkladem těla požadavku)
• tools/call provede HTTP POST na https://api.astroway.info/v1/<path> s tvým ASTROWAY_API_KEY
• Odpověď se vrátí agentovi jako strukturovaný JSON

Každé vydání je navíc dodáváno s SLSA provenance (Sigstore-attested) – to je záruka, že npm balíček byl sestaven přesně z commitu ve veřejném repozitáři.

Instalace

Claude Desktop (macOS)

Přidej do ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restartuj Claude Desktop. V liště pod chatem se objeví 🛠️ indikátor s počtem načtených nástrojů.

Cursor

Přidej do ~/.cursor/mcp.json:

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

Cline / Continue / Windsurf / Copilot / VS Code MCP

Stejný příkaz npx @astroway/mcp funguje v každém klientovi kompatibilním s MCP. Konfigurace je identická – mění se pouze cesta k souboru:

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

Klient	Cesta ke konfiguraci
Cline (VS Code)	.cline/mcp.json v kořeni workspace
Continue	~/.continue/config.json (pod mcpServers)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	preview-flag → mcp.json ve workspace
VS Code MCP extension	~/.vscode/mcp.json

Ostatní MCP klienti

Spusť jako stdio server:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Tip

Získej klíč – na api.astroway.info/dashboard/sign-up. Free tier – 10 000 kreditů/měsíc, bez karty.

Soukromí – od v1.0.0+

Tento MCP server neposílá nic zpět do AstroWay kromě samotných API volání, která mu dáš provést. Žádná telemetrie, žádná analytika, žádný přepínač opt-in/opt-out – ticho ve výchozím nastavení.

Odchozí požadavky nesou dvě identifikační hlavičky, aby AstroWay backend mohl rozlišit MCP provoz od přímého HTTP ve vlastních logech:

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

Žádná z nich neobsahuje session ID, machine fingerprint ani nic osobního. To je standardní User-Agent sémantika – každý CLI nástroj posílá podobné informace.

Registrace podmnožiny – od v1.0.0+

Pokud používáš pouze část katalogu – registruj podmnožinu, aby kontextové okno LLM zůstalo kompaktní:

{
  "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)
  }
}

Běžné skupiny: western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Spusť npx @astroway/mcp --list-tools, abys viděl kompletní sadu.

ASTROWAY_READONLY=1 přeskočí tři skupiny, které interně volají LLM (ai, horoscope, reports) – užitečné, když chceš čistou deterministickou matematiku karet bez utrácení kreditů za generování textu.

Závazek stability – od v1.0.0+

• Katalog je zmrazen po dobu relace. 780+ nástrojů, 12 promptů, 14 zdrojů je vloženo do publikovaného npm balíčku v době buildu – nic se nemění během připojení. Pokud tvůj klient cachuje tools/list po prvním volání – zůstává korektní po celou relaci.
• Identifikátory nástrojů jsou stabilní v rámci major verze. Jméno pod astroway_<group>_<tool> nebude přejmenováno ani odstraněno uvnitř v1.x bez poznámky o zastarání v CHANGELOG.md a souběžné dostupnosti jedné minor verze.
• Tvar vstupu nástroje je stabilní v rámci minor verze. Zpřísnění (regex, range, enum) přichází v patchích; přidání povinného pole vyžaduje minor bump.
• Obnovení katalogu: přeinstalací. npm i -g @astroway/mcp@latest (nebo npx -y @astroway/mcp forma v tvé konfiguraci) stáhne aktuální sadu při dalším spuštění.

Příklady promptů

Po připojení serveru požádej AI:

Nativní mapa

Vypočítej můj nativní horoskop – narozen 15. března 1990, 14:30, Kyjev. Popiš Slunce, Měsíc, Ascendent a najdi těsné aspekty.

Claude zavolá nástroj chart s tvými parametry, obdrží strukturovaný JSON a popíše mapu slovy.

Tranzity

Jaké významné tranzity pomalých planet ovlivní mou nativní mapu během roku 2027?

Claude provede dvě volání nástrojů: nejprve transits (aktuální snímek), poté transit-calendar (rozsah). Interpretuje trendy.

Védská Mahadasha

Spusť Vimshottari Mahadashu pro osobu narozenou 22.07.1985 06:45 v Bombaji. V jakém období se tato osoba nyní nachází?

Přes nástroj vedic/dashas/vimshottari/maha – přesný UTC-timestamp aktuálního období.

Synastrie

Porovnej dvě mapy: A – 10.06.1988 09:15 Londýn, B – 22.11.1991 22:40 Berlín. Jaké jsou nejsilnější křížové aspekty?

Nástroj synastry se dvěma chart bloky + interpretace skóre kompatibility.

Tarot

Vytáhni 3 karty Rider-Waite-Smith: Minulost – Přítomnost – Budoucnost. Otázka: “Mám přijmout novou práci?”. Seed = 42.

tarot/rider-waite/spread s pevným seedem pro reprodukovatelnost.

Seznam všech nástrojů

Po připojení se zeptej Claude:

Vypiš všechny astroway nástroje.

Nebo z příkazového řádku:

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)

Konfigurace

Proměnná	Výchozí hodnota	Popis	Od verze
ASTROWAY_API_KEY	(povinné)	Live: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Přepsání pro self-hosted/staging prostředí.	0.1.0
ASTROWAY_TOOL_GROUPS	(všechny skupiny)	Čárkami oddělené prefixy pro omezení katalogu (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 přeskočí skupiny podporované LLM (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug – úroveň logování na stderr.	0.8.0
LOG_FILE	(nezapisuje se)	Cesta k souboru pro duplikování logů.	0.8.0
MCP_FLAT_TOOLS	0	1 vrátí pre-v0.9 flat jména (chart místo astroway_western_chart). Legacy.	0.9.0

Proč MCP, a ne přímá integrace

Generický LLM (bez grounding) řekne “někdy v červenci Saturn vytvoří trigon k tvému Jupiteru” – bez přesného data, s ±15 dny odchylky. MCP agent provede tool_use POST /v1/transits a vrátí UTC-timestamp s přesností na sekundu, na skutečném Swiss Ephemeris.

Výhoda není v LLM, ale v záruce, že matematika je skutečná – není vymyšlená.

Distribuce balíčku

• mcp.so výpis: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: čeká na schválení (k květnu 2026)
• awesome-mcp-servers (punkpeye): PR #5972

Odkazy

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 API dokumentace: /docs/api/
• 🔑 Registrace: /dashboard/sign-up
• 💰 Ceny: /pricing/
• 🌐 Veřejné repo (MIT): github.com/astroway/astroway-mcp