
astrodynamics-mcp
io.github.astro-tools由 GitHub 帳號 astro-tools 發布v0.4.0更新於 Oct 24, 2026
Astrodynamics MCP server: TLE/SGP4, Lambert, access windows, porkchop, B-plane targeting.
概覽
本機 MCP 伺服器,為助理提供經過驗證的航太動力學工具:TLE/SGP4 傳播、Lambert 求解、可見窗口、豬排圖掃描與 B 平面瞄準。
- 可以做什麼
- 取得並傳播衛星軌道:依 NORAD 編號、名稱或群組查詢 TLE,在多個參考座標系下跨曆元傳播,並查詢衛星中繼資料、進行時間尺度與座標框架轉換。求解軌跡問題:Lambert 解算(含多圈列舉與雙脈衝速度增量)、豬排圖速度增量/C3 網格,以及雙曲線飛掠的 B 平面瞄準。計算地面站可見區間,含 AOS、LOS 與最高仰角。選用擴充會增加 NASA GMAT 任務執行、參數掃描與腳本驗證,SPICE 核載入與星曆查詢,以及 PNG 或 CZML 軌跡圖。
- 適用情境
- 適合需要助理給出真實軌道數值而非估算的情境:任務設計權衡、轉移與飛掠分析、地面站接觸規劃,或用 NASA 資料核對星曆。適合已在處理 TLE、Lambert 問題或 SPICE 核的工程師與研究人員。
- 執行需求
- 以 stdio 本機程序執行,透過 uv tool install 或 pipx 從 PyPI 套件 astrodynamics-mcp 安裝,需要 Python 執行環境。選用擴充 [gmat]、[spice]、[viz] 會增加工具;GMAT 擴充還需在本機安裝 NASA GMAT。需能連線 CelesTrak、JPL Horizons 與 IERS。Space-Track 與 ESA DISCOSweb 需要憑證,透過環境變數或工作階段初始化 _meta 區塊提供。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 astrodynamics-mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
astrodynamics-mcp
A Model Context Protocol server that
gives any MCP-capable LLM client (Claude Code, Cursor, ChatGPT desktop,
custom agents) authoritative astrodynamics tools: TLE/SGP4 propagation,
Lambert solving, ground-station access, time-scale and coordinate-frame
conversions, porkchop scans, B-plane targeting, satellite metadata, and
— with optional extras — full NASA GMAT mission execution ([gmat]),
NASA SPICE / NAIF kernel queries ([spice]), and trajectory visualisation
([viz]).
Why
LLMs reason well about astrodynamics concepts but cannot do the
numerical work — they cannot propagate orbits, solve Lambert problems,
or query SPICE ephemerides. astrodynamics-mcp lets you plug
authoritative tools into any MCP-capable client so the LLM calls vetted
upstream libraries instead of fabricating numbers. Every result carries
explicit units; every tool description tunes against an
Inspect AI eval suite
that measures whether the LLM picks the right tool and binds the right
arguments.
Tools
† Credentialed source. Pass credentials as environment variables for
the stdio transport, or in the session-init _meta block for HTTP — see
Credentials.
A tool called without its credential returns a typed
CredentialRequiredError, never a silent failure.
GMAT tools (optional [gmat] extra)
Install the [gmat] extra and have a local NASA GMAT
install, and five more tools register for driving real GMAT missions
(they stay hidden otherwise):
SPICE tools (optional [spice] extra)
Install the [spice] extra and seven more tools register, backed by NASA
NAIF's CSPICE through spiceypy
(they stay hidden otherwise). They furnish kernels into a process-global
pool and query whatever the pool holds:
The kernel model, the NAIF furnish-from-URL allowlist, and the process-global pool's trust boundary are covered on the SPICE integration page.
Visualisation tools (optional [viz] extra)
Install the [viz] extra and four more tools register, backed by
matplotlib (static PNG plots) and the
gmat-czml sibling (CZML export)
— they stay hidden otherwise. Each returns its picture as an attachment
alongside a numeric summary, so a text-only client still gets the answer:
The attachment model — additive PNG ImageContent / CZML EmbeddedResource
beside the structured summary — and which clients render each kind are covered
on the
Visualisation
page.
Full input / output JSON schemas live on the Tool reference page of the docs site.
Quick start
Install:
Claude Code
Add to your Claude Code MCP settings:
Restart Claude Code. In a chat:
You: Compute the Hohmann Δv from a 250 km circular LEO to GEO.
(The model calls
lambert_solvewith the Hohmann geometry and answers ≈ 3.91 km/s, citing the tool output — not the LLM's own weights.)
Cursor
~/.cursor/mcp.json (or workspace-level .cursor/mcp.json):
Restart Cursor. The tools appear under the astrodynamics server group.
See Pick a client in the docs for ChatGPT desktop, a raw Python MCP smoke client, and the Streamable HTTP transport for remote agents.
Supported clients
What this is not
- Not a general-purpose astrodynamics framework. Wraps vetted upstream libraries; does not re-implement propagators, integrators, or coordinate systems.
- Not an agent framework. Exposes MCP tools; LangGraph, AutoGen, CrewAI, and the LLM clients themselves consume them.
- Not an ML / inference server. Tools that need their own ML models (maneuver detection, neural propagators) belong in separate MCP servers — kept modular for dependency isolation.
- Not a SaaS. Runs locally or in your own infrastructure. No hosted multi-tenant deployment.
- Not a web UI. Tool consumption is via MCP clients; no browser frontend, no desktop app, no notebook widget.
For direct (non-MCP) Python use of the same surfaces, reach for the
upstream libraries:
sgp4,
lamberthub,
skyfield,
astropy,
interplanetary-porkchop,
spiceypy.
Built on
The official Anthropic
modelcontextprotocol/python-sdk
(MIT). The bundled FastMCP server class is the server primitive;
stdio + Streamable HTTP transports are first-class.
Docs and links
- Docs site: astro-tools.github.io/astrodynamics-mcp — getting started, per-client setup, tool reference, recipes, visualisation, data sources, eval suite, FAQ.
- Issue tracker: astro-tools/astrodynamics-mcp/issues
- Discussions: orgs/astro-tools/discussions — usage help and open-ended questions.
- Eval suite: eval/README.md — the regression contract on tool-description quality.
Privacy
astrodynamics-mcp runs entirely on your own machine and collects
nothing — no telemetry, no analytics, no accounts. The only data that
leaves your machine is the query parameters a tool sends to the data
source it wraps (CelesTrak / JPL Horizons / IERS with no auth, and —
only if you configure their credentials — Space-Track and ESA DISCOSweb).
Credentials are read from local environment variables or the session
_meta block and are sent only to their own service over HTTPS. See the
Privacy page
for the full breakdown.
License
MIT — see LICENSE.
來源:README.md,提交 5ef20e7
工具
0版本歷史
1- v0.4.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分