
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 分