kshana-mcp: kysy tekoälyavustajaltasi, ja moottori vastaa

kshana-mcp on Model Context Protocol (MCP) -palvelin tuotteelle Kshana, avoimen lähdekoodin simulaattorille PNT-kestävyyden (paikannus, navigointi ja ajanmääritys) tutkimiseen. Sen avulla tekoälyavustaja (AI, artificial intelligence) voi ajaa oikean moottorin ja lukea sen JSON-tulosteen (JavaScript Object Notation) matematiikan arvaamisen sijaan. Se puhuu stdion (standard input and output, vakiosyöte ja -tuloste) kautta mille tahansa MCP-yhteensopivalle asiakkaalle, mukaan lukien Cursor ja JetBrains AI Assistant / Junie.

Matematiikka, jolle Kshana on validoitu, on juuri se, missä kielimalli arvaa huonosti: SGP4 (Simplified General Perturbations 4) -radanlaskenta, IAU:n (International Astronomical Union) koordinaatistot, Allanin poikkeamat, GNSS:n (maailmanlaajuinen satelliittinavigointijärjestelmä) saatavuus ja DOP (tarkkuuden heikkenemiskerroin), ARAIM:n (advanced receiver autonomous integrity monitoring) suojaustasot, GNSS:n ja INS:n (inertianavigointijärjestelmä) fuusio sekä kvanttisensorimallit. Kysy; avustaja ajaa oikean skenaarion ja saa laatumittarit lähteineen ja merkintöineen VALIDATED tai MODELLED.

Työkalut#

Jokainen työkalu on ohut, uskollinen kääre kirjaston kshana julkiselle funktiolle — tähän ei sijoitu uutta simulaatiologiikkaa, joten agentti ajaa täsmälleen validoitua moottoria.

GNSS IQ -työkalut: tiedostot sisään, tiivis JSON ulos#

IQ-tallenteet kasvavat gigatavuiksi, joten työkalut iq_* eivät koskaan välitä näytteitä protokollan kautta. Ne noudattavat yhtä sopimusta:

• Työhakemisto. Palvelin lukee ja kirjoittaa IQ-tiedostoja vain kansion sisällä, jonka nimeää KSHANA_MCP_IQ_DIR. Jokainen polkuargumentti on suhteessa siihen (absoluuttisen polun on ratkettava sen sisään); syötteet ratkaistaan symbolisten linkkien läpi ennen tarkistusta, tulosteen kansion on jo oltava siinä, ja olemassa oleva tuloste korvataan vain valitsimella overwrite: true. Asettamattomana IQ-tiedostotyökalut ovat pois päältä ja kertovat, miten ne otetaan käyttöön; kaikkiin muihin työkaluihin tämä ei vaikuta.
• Näytebudjetti. Yksi kutsu tuottaa tai käsittelee enintään KSHANA_MCP_IQ_MAX_SAMPLES kompleksinäytettä (oletus 50 000 000). Tavuina se on 400 MB muodossa cf32_le (8 tavua kompleksinäytettä kohden), 200 MB muodossa ci16_le (4 tavua) ja 100 MB muodossa ci8 (2 tavua); kohtaus kirjoitetaan muodossa cf32_le, ellei format toisin sano. Tarkistus tehdään ennen mitään työtä, ja hylkäys nimeää keston tai arvon max_seconds, joka mahtuu.
• Tiiviit vastaukset. Jokainen työkalu vastaa yhdellä JSON-yhteenvedolla: hakupiikit, C/N0, lukitustila ja jokainen kirjoitettu tiedosto polkuineen ja tavumäärineen. Epookkikohtaiset taulukot menevät nimeämiisi tiedostoihin json_out / csv_out.
• Tuntemattomat argumentit hylätään, ei ohiteta, joten virheellisesti kirjoitettu valitsin on virhe.

Jokainen työkalu ajaa saman koodipolun kuin komento kshana iq komentorivillä, prosessin sisällä. Kerros on vain ohjelmistoa: se kirjoittaa tiedostoja ohjelmistovastaanottimille eikä ohjaa radiolaitteistoa. IQ-kerros ei lisää häiriön tai harhauttajan synteesiä, eikä mitään koskaan lähetetä. (Erillinen skenaariolaji spectrum voi kirjoittaa analyyttisiä häirintälähettimen IQ-otoksia tiedostoon.)

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

Docker-imagea käytettäessä liitä kansio ja osoita muuttuja siihen: docker run --rm -i -v "$PWD/iq:/iq" -e KSHANA_MCP_IQ_DIR=/iq ghcr.io/ashfordeou/kshana-mcp.

Jokainen laji on tavoitettavissa#

Työkalu run_scenario ohjaa skenaarion kentän kind mukaan, joten jokainen laji, jonka työkalu list_scenario_kinds nimeää, ajetaan sen kautta. Siihen kuuluvat uudemmat perheet, joille kullekin on mukana toimitettuja esimerkkejä, jotka agentti voi hakea:

Työkalu list_example_scenarios argumentilla kind nimeää jokaisen mukana toimitetun kyseisen lajin esimerkin. Animaatiot, raportit ja yhteentoimivuusviennit eivät ole lajeja: ne ovat ajon näkymiä, ja animate_scenario, report_scenario ja export_interop palauttavat ne mille tahansa skenaariolle, johon ne soveltuvat.

Ei tarjota: tutkimussarjat (kshana --study <suite.toml>), koska sarja nimeää levyllä olevia sisarskenaariotiedostoja eikä skenaariotyökalu lue tiedostoja. Aja jokainen jäsen työkalulla run_scenario. (IQ-työkalut kyllä lukevat ja kirjoittavat tiedostoja, vain työhakemistonsa sisällä.)

Asenna MCP-palvelin#

Ohjeellinen, ei tyyppihyväksytty navigointilaite: käyttäjä vastaa edelleen navigoinnista. Palvelin toimii tietokoneellasi; Ashforde OÜ:lle ei lähetetä mitään.

Kolmansien osapuolten tekoälyasiakkaita nimeävä kappale on jätetty tästä pois; se on tiedostossa mcp/kshana-mcp/README.md GitHubissa.

Kloonatusta työkopiosta tai gitistä (kehitys):

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

HTTP-tila (itse ylläpidetty)#

kshana-mcp --http 127.0.0.1:8080 tarjoaa samat työkalut streamable HTTP:n yli osoitteessa /mcp. Se sitoutuu vain loopbackiin; muu kuin loopback-osoite vaatii valitsimen --allow-remote ja bearer-tunnuksen muuttujassa KSHANA_MCP_HTTP_TOKEN; IQ-tiedostotyökalut ovat pois päältä; pyynnön koko, aika ja samanaikaisuus on rajattu; CORS-otsaketta ei lähetetä. Kshana ei isännöi päätepistettä: se ylläpidetään itse. Katso docs/deploy/mcp-http.md.

cargo install asentaa binäärin kshana-mcp polkuun PATH (tyypillisesti ~/.cargo/bin/kshana-mcp). Palvelin puhuu JSON-RPC:tä (JSON remote procedure call) stdion yli; lokit menevät stderriin. Lähdekoodista rakentaminen vaatii Rust-työkaluketjun ≥ 1,88 (korjattu SDK rmcp 2.x vaatii sen, ja niin vaatii myös kirjasto kshana); Docker-image ei vaadi mitään.

Rekisteröi se asiakkaalle#

Käytännössä jokainen MCP-asiakas käyttää samaa asetuslohkoa mcpServers — rekisteröi binääri kshana-mcp absoluuttisella polulla:

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

Tai Docker-imagella paikallisen binäärin sijaan (ei tarvita PATH):

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

Missä lohko sijaitsee, riippuu asiakkaasta:

• Cursor — ~/.cursor/mcp.json (yleinen) tai .cursor/mcp.json (projektikohtainen).
• JetBrains AI Assistant / Junie — Settings → Tools → AI Assistant → Model Context Protocol → Add → As JSON, liitä lohko ja käynnistä sitten IDE (integrated development environment) kokonaan uudelleen.
• Työpöytäavustajat — useimmat käyttävät tiedostoa …_config.json samalla rakenteella mcpServers; tarkista tiedoston sijainti asiakkaasi ohjeista.
• CLI-agentit — monet hyväksyvät saman JSONin mekanismilla mcp add / mcp.json.

Käytä aina binäärin absoluuttista polkua. Aseta RUST_LOG=debug osiossa env vianmääritystä varten (diagnostiikka menee stderriin; stdout on varattu JSON-RPC-protokollalle).

Kokeile#

Rekisteröinnin jälkeen kysy avustajaltasi esimerkiksi:

• ”Luettele Kshana-skenaariolajit.” → list_scenario_kinds
• ”Näytä minulle Kshana-spektriesimerkki ja aja se.” → list_example_scenarios, get_example_scenario, run_scenario
• ”Aja Kshana-skenaario kellon holdoverista kynnysarvolla 20 ns ja 2 tunnin GNSS-katkolla; miten kvanttikellon ja klassisen kellon holdover vertautuvat?” → run_scenario
• ”Vie tuo GPS-tähdistö (Global Positioning System) SP3-muodossa.” → export_sp3
• ”Anna minulle realtime-frame-eop-taulukko CSV:nä.” → export_table_csv
• ”Aseta tuo Iridium-ylilento Cesium-karttapallolle.” → list_export_formats, export_interop
• ”Animoi häirintäkampanja.” → animate_scenario
• ”Anna raportti tuosta ajosta toistettavuustietueineen.” → report_scenario
• ”Tee yhden sekunnin GPS L1 -kohtaus PRN:illä 3 ja 17, sitten hae ja seuraa sitä.” → iq_signals, iq_scene, iq_acquire, iq_track

Suunnitteluhuomautus — miksi erillinen crate#

Palvelin on itsenäinen, työtilan ulkopuolelle jätetty crate, jolla on oma Cargo.lock, joten virallinen Rust MCP SDK (software development kit) rmcp ja sen asynkroninen ajonaikainen ympäristö eivät koskaan päädy julkaistun craten kshana riippuvuuskuvaajaan: kirjasto- tai Python-käyttäjä ei käännä palvelinta, jota ei aja. (Se erotettiin ensin, koska rmcp käyttää editionia 2024, mikä vaatii rustc ≥ 1,85, kun pääcrate lupasi silloin 1,75. Kirjasto ja tämä palvelin ilmoittavat nyt molemmat 1,88, tietoturvakorjatun version rmcp 2.x ja päivitettyjen RustCrypto-cratejen alarajan.) Jatkuva integrointi (CI) portittaa tämän craten erikseen — testit ja cargo deny sen omaa lukitustiedostoa vasten. rmcp:n lisenssipuu on puhdas (Apache-2.0/MIT/BSD), joten toisin kuin ristiinvalidointicrate xval/anise-frames, jota se muuten peilaa, jako ei johdu lisensoinnista.

Lisenssi: AGPL-3.0-only, GNU Affero General Public License versio 3 vain (tai kaupallinen lisenssi Ashforde OÜ:ltä; katso repositorion LICENSING.md).