kshana-mcp: küsige oma tehisintellekti assistendilt ja mootor vastab

kshana-mcp on Model Context Protocol (MCP) server projektile Kshana, avatud lähtekoodiga simulaatorile PNT (positsioneerimine, navigatsioon ja aeg) vastupidavuse jaoks. See laseb tehisintellekti (AI) assistendil käivitada päris mootori ja lugeda tagasi selle JSON-i (JavaScript Object Notation), selle asemel et matemaatikat ära arvata. See räägib stdio (standardsisend ja -väljund) kaudu mis tahes MCP-ühilduva kliendiga, sealhulgas Cursori ja JetBrains AI Assistant / Junie'ga.

Matemaatika, milleks Kshana on valideeritud, on täpselt see, kus keelemudel arvab halvasti: SGP4 (Simplified General Perturbations 4) orbiidi levitamine, IAU (Rahvusvaheline Astronoomia Liit) tugisüsteemid, Alani hälbed, GNSS (ülemaailmne satelliitnavigatsioonisüsteem) kättesaadavus ja DOP (täpsuse halvenemise tegur), ARAIM (täiustatud vastuvõtja autonoomne terviklikkuse seire) kaitsetasemed, GNSS-i ja INS-i (inertsiaalnavigatsioonisüsteem) liitmine ning kvantsensorite mudelid. Esitage küsimus; assistent käivitab päris stsenaariumi ja saab kvaliteedinäitajad koos nende päritolu ning nende VALIDATED või MODELLED märgisega.

Tööriistad#

Iga tööriist on õhuke, truu ümbris teegi kshana avaliku funktsiooni ümber — siin ei ela uut simulatsiooniloogikat, nii et agent käitab täpselt valideeritud mootorit.

GNSS IQ tööriistad: failid sisse, kompaktne JSON välja#

IQ salvestused ulatuvad gigabaitideni, seega ei lase tööriistad iq_* valimeid kunagi protokolli kaudu läbi. Need järgivad ühte lepingut:

• Töökataloog. Server loeb ja kirjutab IQ-faile ainult kaustas, mille nimetab KSHANA_MCP_IQ_DIR. Iga teeargument on selle suhtes suhteline (absoluutne tee peab lahenduma selle sees); sisendid lahendatakse enne kontrolli läbi sümlinkide, väljundi kaust peab selle sees juba olemas olema ja olemasolev väljund asendatakse ainult koos overwrite: true. Seadmata korral on IQ-failitööriistad välja lülitatud ja ütlevad, kuidas neid lubada; iga teine tööriist jääb puutumata.
• Valimieelarve. Üks kutse genereerib või töötleb kuni KSHANA_MCP_IQ_MAX_SAMPLES kompleksvalimit (vaikimisi 50 000 000). Baitides on see 400 MB kujul cf32_le (8 baiti kompleksvalimi kohta), 200 MB kujul ci16_le (4 baiti) ja 100 MB kujul ci8 (2 baiti); stseen kirjutatakse kujul cf32_le, kui format ei ütle teisiti. Kontroll toimub enne mis tahes tööd ja tagasilükkamine nimetab kestuse või max_seconds, mis mahub.
• Kompaktsed vastused. Iga tööriist vastab ühe JSON-kokkuvõttega: hõivamistipud, C/N0, lukuolek ja iga kirjutatud fail oma tee ja baidiarvuga. Epohhipõhised tabelid lähevad failidesse json_out / csv_out, mille te nimetate.
• Tundmatud argumendid lükatakse tagasi, mitte ei ignoreerita, nii et valesti kirjutatud valik on viga.

Iga tööriist käitab sama kooditeed nagu kshana iq käsureal, protsessi sees. Kiht on ainult tarkvara: see kirjutab faile tarkvaravastuvõtjatele ega juhi ühtki raadioriistvara. IQ kiht ei lisa häirete ega spuufija süntesaatorit ja midagi ei edastata kunagi. (Eraldi stsenaariumi liik spectrum võib kirjutada analüütilisi segaja IQ hetktõmmiseid faili.)

{
  "mcpServers": {
    "kshana": {
      "command": "/Users/you/.cargo/bin/kshana-mcp",
      "env": { "KSHANA_MCP_IQ_DIR": "/Users/you/iq" }
    }
  }
}

Dockeri kujutisega ühendage kaust ja suunake muutuja sellele: docker run --rm -i -v "$PWD/iq:/iq" -e KSHANA_MCP_IQ_DIR=/iq ghcr.io/ashfordeou/kshana-mcp.

Iga liik on kättesaadav#

run_scenario suunab stsenaariumi kind-i järgi, nii et iga liik, mille list_scenario_kinds nimetab, jookseb selle kaudu. See hõlmab uuemaid perekondi, igaühel kaasasolevad näited, mille agent saab tuua:

list_example_scenarios koos väljaga kind nimetab selle liigi iga kaasasoleva näite. Animatsioonid, aruanded ja koostalitlusekspordid ei ole liigid: need on jooksu vaated ning animate_scenario, report_scenario ja export_interop tagastavad need iga stsenaariumi jaoks, millele need kehtivad.

Ei teenindata: uuringukomplektid (kshana --study <suite.toml>), sest komplekt nimetab kettal naaberstsenaariumifaile ja stsenaariumitööriistad ei loe ühtki faili. Käivitage iga liige käsuga run_scenario. (IQ tööriistad loevad ja kirjutavad faile, ainult oma töökataloogis.)

Paigaldage MCP server#

Nõuandev, mitte tüübikinnitust omav navigatsiooniseade: navigeerimise eest vastutab jätkuvalt operaator. Server töötab kasutaja arvutis; Ashforde OÜ-le ei saadeta midagi.

Lõik, mis nimetab kolmandate osapoolte tehisintellekti kliente, on siit välja jäetud; see on GitHubis failis mcp/kshana-mcp/README.md.

Väljavõtmisest või gitist (arendus):

cd mcp/kshana-mcp && cargo install --path .
cargo install --git https://github.com/AshfordeOU/kshana kshana-mcp

HTTP-režiim (ise majutatud)#

kshana-mcp --http 127.0.0.1:8080 teenindab samu tööriistu voogedastatava HTTP kaudu aadressil /mcp. See seob ainult loopbacki; mitte-loopback aadress vajab --allow-remote ja bearer-tokenit muutujas KSHANA_MCP_HTTP_TOKEN; IQ-failitööriistad on välja lülitatud; päringu suurus, aeg ja samaaegsus on piiratud; CORS-päist ei saadeta. Kshana ei majuta lõpp-punkti: te majutate seda ise. Vt docs/deploy/mcp-http.md.

cargo install paneb kshana-mcp teie teele PATH (tavaliselt ~/.cargo/bin/kshana-mcp). Server räägib JSON-RPC-d (JSON remote procedure call) stdio kaudu; logid lähevad stderr-i. Lähtekoodist ehitamine vajab Rusti tööriistaahelat ≥ 1,88 (parandatud rmcp 2.x SDK vajab seda ja nii ka teek kshana); Dockeri kujutis ei vaja ühtki.

Registreerige see kliendiga#

Praktiliselt iga MCP klient kasutab sama mcpServers seadistusplokki — registreerige binaarfail kshana-mcp absoluutse teega:

{
  "mcpServers": {
    "kshana": {
      "command": "/Users/you/.cargo/bin/kshana-mcp",
      "args": [],
      "env": {}
    }
  }
}

Või Dockeri kujutisega kohaliku binaarfaili asemel (PATH pole vaja):

{
  "mcpServers": {
    "kshana": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/ashfordeou/kshana-mcp"]
    }
  }
}

Kus see plokk asub, sõltub kliendist:

• Cursor — ~/.cursor/mcp.json (globaalne) või .cursor/mcp.json (projekti kohta).
• JetBrains AI Assistant / Junie — Settings → Tools → AI Assistant → Model Context Protocol → Add → As JSON, kleepige plokk, seejärel taaskäivitage IDE (integreeritud arenduskeskkond) täielikult.
• Töölaua assistendid — enamik kasutab faili …_config.json sama kujuga mcpServers; kontrollige faili asukohta oma kliendi dokumentatsioonist.
• CLI agendid — paljud aktsepteerivad sama JSON-it mehhanismi mcp add / mcp.json kaudu.

Kasutage binaarfailile alati absoluutset teed. Veaotsinguks seadke RUST_LOG=debug plokis env (diagnostika läheb stderr-i; stdout on reserveeritud JSON-RPC protokollile).

Proovige#

Kui see on registreeritud, küsige oma assistendilt selliseid asju nagu:

• „Loetle Kshana stsenaariumi liigid.“ → list_scenario_kinds
• „Näita mulle Kshana spektri näidet ja käivita see.“ → list_example_scenarios, get_example_scenario, run_scenario
• „Käivita Kshana kella holdover stsenaarium 20 ns lävega ja 2-tunnise GNSS-i katkestusega; mis on kvant- ja klassikalise holdover-i vahe?“ → run_scenario
• „Ekspordi see GPS (Global Positioning System) konstellatsioon SP3-na.“ → export_sp3
• „Anna mulle tabel realtime-frame-eop CSV-na.“ → export_table_csv
• „Pane see Iridiumi ülelend Cesiumi gloobusele.“ → list_export_formats, export_interop
• „Animeeri segamise kampaania.“ → animate_scenario
• „Anna mulle selle jooksu aruanne koos selle reprodutseeritavuse kirjega.“ → report_scenario
• „Tee ühesekundiline GPS L1 stseen PRN-idega 3 ja 17, seejärel hõiva ja jälgi seda.“ → iq_signals, iq_scene, iq_acquire, iq_track

Kavandi märkus — miks eraldi crate#

Server on eraldiseisev, tööruumist välja jäetud crate oma failiga Cargo.lock, nii et ametlik Rusti MCP SDK (tarkvaraarenduskomplekt) rmcp ja selle asünkroonne käituskeskkond ei satu kunagi avaldatud kshana crate'i sõltuvusgraafi: teegi või Pythoni kasutaja ei kompileeri serverit, mida ta ei käita. (See eraldati esmalt seetõttu, et rmcp on edition 2024, mis vajab rustc ≥ 1,85, samas kui põhicrate lubas siis 1,75. Teek ja see server deklareerivad nüüd mõlemad 1,88, mis on turvaparandusega rmcp 2.x ja uuendatud RustCrypto cratede alampiir.) Pidev integreerimine (CI) kontrollib seda crate'i eraldi — testid ja cargo deny selle lukufaili vastu. rmcp litsentsipuu on puhas (Apache-2.0/MIT/BSD), seega erinevalt ristvalideerimise crate'ist xval/anise-frames, mida see muidu järgib, ei ole eraldamine litsentsimise pärast.

Litsents: AGPL-3.0-only, GNU Affero General Public License versioon 3 ainult (või Ashforde OÜ kommertslitsents; vt hoidla LICENSING.md).