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.

已验证STDIO仅桌面数据与分析AI 与机器学习

概览

AI 生成的概览

本地 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 块提供。
安装前请注意
Space-Track 与 ESA DISCOSweb 的凭据从环境变量或会话 _meta 块读取,缺失时相关工具返回 CredentialRequiredError。查询参数会发送至 CelesTrak、JPL Horizons、IERS,若已配置还会发送至 Space-Track 与 DISCOSweb。GMAT 执行脚本工具会运行原始 GMAT 脚本文本,SPICE 工具会从本地路径或白名单 NAIF 网址把核加载进进程级共享池,因此应把核来源视为可信输入。

安装

在 SourceWeft 中

  1. 打开 控制台中的 astrodynamics-mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

ToolWhat it doesBacked by
tle_lookupFetch current TLEs by NORAD ID, name, or group — from CelesTrak (default) or Space-Track.CelesTrak gp.php API · Space-Track †
sgp4_propagatePropagate TLEs across UTC ISO 8601 epochs in TEME / ICRF / GCRS / ITRS / CIRS.sgp4
lambert_solveSolve Lambert's problem; multi-rev solutions enumerated; two-impulse Δv on demand.lamberthub
access_windowsGround-station / observer access intervals over a window, with AOS / LOS / peak elevation.skyfield
time_convertUTC / TAI / TT / TDB / UT1 / GPS / TCB / TCG conversions across ISO / JD / MJD / J2000-seconds / Unix.astropy.time
frame_transformState-vector transforms across ICRF / ITRS / GCRS / TEME / CIRS / TIRS / IAU body-fixed frames.astropy.coordinates
porkchop(depart × arrive) Δv / C3 grid for interplanetary transfers, ASCII contour, summary or full output.lamberthub + JPL Horizons
bplane_targetB-plane element calculation and impulsive targeting for hyperbolic flybys.in-house, JPL Horizons fed
satellite_metadataPhysical & provenance metadata (mass, dimensions, COSPAR ID, launch, operator, decay status) for a NORAD ID.ESA DISCOSweb †

† 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):

ToolWhat it doesBacked by
gmat_run_missionRun a complete GMAT mission; returns a parsed summary, report data, and pointers to large outputs.gmat-run
gmat_sweepParameter sweeps and Monte Carlo (grid / samples / Monte Carlo / Latin hypercube) over a mission.gmat-sweep
gmat_execute_scriptEscape hatch — run raw GMAT script text and return its reports verbatim; engine errors come back as data.gmat-run
gmat_validate_scriptParse-validate a script without running it; returns errors, warnings, and the resource/command structure.gmat-run
gmat_read_run_artefactRead the raw text of a file produced by a prior run (ephemerides, reports too large to inline).run registry

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:

ToolWhat it doesBacked by
spice_load_kernelFurnish a kernel into the pool from a local path or a NAIF https URL (allowlisted, cached); a meta-kernel furnishes all it lists.spiceypy · NAIF
spice_list_kernelsList the kernels currently furnished in the pool, optionally filtered by category.spiceypy
spice_unload_kernelDrop a furnished kernel by the name spice_load_kernel returned.spiceypy
spice_statePosition / velocity of a target relative to an observer at one or more epochs, from furnished SPK kernels.spiceypy (SPK)
spice_frame_transformRotate a vector between kernel-defined frames — in particular non-Earth body-fixed frames — or return the rotation matrix.spiceypy (FK / PCK)
spice_body_parametersRead a body's radii, GM, and pole / prime-meridian orientation constants from furnished PCK kernels.spiceypy (PCK)
spice_time_convertConvert between the kernel-defined time systems ET / UTC / SCLK using furnished LSK / SCLK kernels.spiceypy (LSK / SCLK)

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:

ToolWhat it doesBacked by
plot_ground_trackRender a satellite's sub-satellite ground track as a PNG over a lon/lat graticule, with the latitude / longitude extent inline.matplotlib
plot_trajectoryRender an orbit or transfer arc as a 2D or 3D PNG about a central body, with arc length and apsides inline.matplotlib
plot_porkchopRender a porkchop C3 contour as a PNG from a full porkchop grid result — no recompute — with the best cell marked.matplotlib
czml_trajectoryExport a trajectory as a CZML document for a Cesium 3D client, returned as an embedded resource.gmat-czml

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:

bash
uv tool install astrodynamics-mcp            # or: pipx install astrodynamics-mcpuv tool install "astrodynamics-mcp[gmat]"    # adds the GMAT mission tools (needs a local GMAT install)uv tool install "astrodynamics-mcp[spice]"   # adds the SPICE tools (pulls spiceypy / bundled CSPICE)uv tool install "astrodynamics-mcp[viz]"     # adds the visualisation tools (pulls matplotlib / gmat-czml)

Claude Code

Add to your Claude Code MCP settings:

json
{  "mcpServers": {    "astrodynamics-mcp": {      "command": "astrodynamics-mcp",      "args": ["stdio"]    }  }}

Restart Claude Code. In a chat:

You: Compute the Hohmann Δv from a 250 km circular LEO to GEO.

(The model calls lambert_solve with 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):

json
{  "mcpServers": {    "astrodynamics-mcp": {      "command": "astrodynamics-mcp",      "args": ["stdio"]    }  }}

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

ClientTransportVerified
Claude Codestdio✅ Yes
Cursorstdio✅ Yes
ChatGPT desktopstdio⏳ Expected to work
Raw Python (mcp SDK)stdio✅ Yes
Remote agentsStreamable HTTP⏳ Expected to work
LangGraph / AutoGen / CrewAIany⏳ Expected to work

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

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
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.4.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分