LUNA (On Step Ninja)

LUNA——人工智能驱动的望远镜和天文台控制器

ESP32上的MCP服务器+Lua脚本引擎

让Claude AI用通俗易懂的语言控制你的望远镜、相机和整个天文台。

______________________________________________________________________

LUNA文档（笔记本LM）

📚 LUNA文档--从这里开始获取安装指南、技术参考和常见问题解答。 直接在NotebookLM中提问，并从官方文档中获得答案。 👉 https://notebooklm.google.com/notebook/f2ce997f-18c2-44c4-8738-973b204c190c

💬 AiBridgeMCP社区——加入我们的Facebook群组，提问、分享您的结果，并与其他用户联系。开发者也是会员。欢迎大家光临。 👉 https://www.facebook.com/groups/1230935959149731

______________________________________________________________________

什么是LUNA？

LUNA是ESP32的固件，它将ESP32转换为 MCP（模型上下文协议）服务器，内置Lua脚本引擎.

将LUNA连接到您的望远镜或天文台设备，然后通过Claude AI以通俗易懂的语言控制一切。

You ──→ Claude AI ──→ LUNA (ESP32) ──→ Telescope / Serial Device
              "Go to M42"    serial command    🔭 slews

You ──→ Claude AI ──→ LUNA (ESP32) ──→ NINA (PC) ──→ Camera / Focuser / Guider
         "Image M42 tonight"   HTTP API       🌟 full automation

LUNA运行 Lua自主编写脚本 在ESP32上。Claude编写脚本、部署脚本并监控结果——所有这些都是通过MCP协议完成的。

Hardware_Pinout_RS232C_Wiring_Guide

LUNA Observatory System v5.9.6

______________________________________________________________________

★ v5.9.3中的新功能——Vixen Mount支持（UDP）

LUNA现在支持 Vixen无线单元 通过UDP挂载（AXD、SXP、SXD2、AP、SX2、AXJ、SXP2），以及 《Vixen STAR》第十册 通过HTTP——通过新的 udp.* Lua模块。

-- Example: slew Vixen Wireless Unit to a target
udp.begin(50000)
udp.connect("192.168.6.1", 60023)
udp.write("$MTTGT=1,83.82,−5.39,Orion Nebula\r\n")
udp.write("$MTMV2\r\n")
local resp = udp.read(2000)
udp.close()
log.write("GoTo response: " .. (resp or "timeout"))

Claude通过以下方式在内部了解完整的Vixen命令集 vixen_guide --告诉它该指向哪里。

______________________________________________________________________

★ v5.9.2中的新功能——NINA天文摄影集成

LUNA现在控制 NINA（夜间成像“N”天文学） -世界上最受欢迎的免费天文摄影软件-直接通过其HTTP API。

这意味着什么

已验证工作（2026-03-27）

✅ Camera connection and status
✅ Capture start / stop
✅ Autofocus
✅ Filter wheel control
✅ Sequence start / stop
✅ Guider start / stop
✅ ASCOM / Alpaca device control (switch, weather sensor)
✅ Stellarium integration

运作原理

"Image M42 tonight"

  ① Check weather sensors → safe to observe?     (LUNA + Alpaca)
  ② Slew telescope to M42                         (Alpaca)
  ③ Run autofocus                                 (NINA HTTP API)
  ④ Test exposure → plate solve → correct pointing (NINA HTTP API)
  ⑤ Start main imaging sequence                   (NINA HTTP API)
  ⑥ Re-focus periodically as temperature drops    (NINA HTTP API)
  ⑦ Auto-abort if weather deteriorates            (LUNA monitoring)

NINA是“手”，克劳德是“大脑”，LUNA是“神经系统”

NINA集成要求

• NINA v3.x-- 夜间想象.eu （免费）
• NINA高级API插件（免费，从NINA内部安装）
• 端口： 1888 （默认），API已启用： 开
• LUNA和NINA PC位于同一WiFi网络上

______________________________________________________________________

主要特点

• MCP服务器 --通过模型上下文协议直接连接到Claude
• Lua 5.1脚本引擎 --在ESP32上编写、保存和运行脚本
• 自主操作 --脚本独立运行；克劳德根据需要进行监控和干预
• Vixen支架 --无线单元（UDP）和STAR BOOK TEN（HTTP）通过新的 udp.* 模块（v5.9.3）
• NINA集成 --通过HTTP POST控制天文摄影软件（v5.9.2）
• http模块 — http.get / http.put / http.post 用于ASCOM/Alpaca、NINA Advanced API和Vixen STAR BOOK TEN
• udp模块 — udp.begin / udp.connect / udp.write / udp.read / udp.close 适用于Vixen无线单元（v5.9.3）
• MCP资源 --克劳德自然地读取设备状态，就像读取仪表一样
• 脚本到脚本数据传递 — log.save() / log.load() 无需Claude即可启用有状态工作流
• 串行设备控制 --全RS-232C控制 serial.query(), serial.write(), serial.read()
• FreeRTOS双核 --MCP服务器和Lua引擎在单独的内核上运行；无阻塞

______________________________________________________________________

支持的设备

PC软件集成（v5.9.2+）

Vixen Mount集成（v5.9.3）

LUNA与 任何RS-232C串行设备 以及任何 ASCOM/羊驼兼容设备 在您的局域网上。

______________________________________________________________________

需求

硬件

• ESP32开发板 （ESP32 DevKitC或兼容）
• RS-232C接口电路（MAX3232或同等产品）
• 功率： 通过微型USB连接5V （移动电源或USB充电器）

即用型LUNA板 （LUNA OnStepNinja V2——预连线、预闪存）可从作者处获得。

软件/服务

• 克劳德桌面版 （免费）
• MCP连接器（包含在GitHub发布下载包中）

______________________________________________________________________

入门指南

步骤1--闪存固件

从下载固件二进制文件 :

使用esptool或ESP32 Flash下载工具闪存到ESP32。

📄 看 LUNA_Quick_Setup_Guide.md 获取完整说明。

步骤2--将Claude Desktop连接到LUNA

使用下载包中包含的MCP连接器配置Claude Desktop。

📄 看 LUNA_Quick_Setup_Guide.md 对于3步设置。

第三步——开始用望远镜说话

You:    "Go to M42"
Claude: → slews telescope to M42

You:    "Image M42 tonight, 3 minutes per frame, 20 frames"
Claude: → autofocuses, plate solves, starts NINA sequence

______________________________________________________________________

示例：全天文台自动化

-- LUNA Lua script: check weather, then start NINA sequence
local resp, code = http.get(
  "http://192.168.x.x/api/v1/observingconditions/0/humidity", 2000)

if code == 200 then
  local humidity = -- parse resp
  if humidity  ⚠️ **电缆注意事项：** 使用一个 **直RS-232C电缆** 在LUNA和PC之间。
> 使用一个 **交叉电缆** 在LUNA和NS-5000/OnStep之间。

联系人： 

______________________________________________________________________

## 文档

|文档|描述|
|----------|-------------|
| [LUNA_Quick_Setup_Guide.md](docs/LUNA_Quick_Setup_Guide.md) |首次设置（3个步骤）|
| [LUNA_USER_MANUAL.md](docs/LUNA_USER_MANUAL.md) |完整参考手册|
| [LUNA_Lua_Guide.md](docs/LUNA_Lua_Guide.md) |Lua脚本编写指南|

📚 **[NotebookLM上的LUNA文档](https://notebooklm.google.com/notebook/f2ce997f-18c2-44c4-8738-973b204c190c)** --直接询问有关LUNA的问题。

______________________________________________________________________

## 许可证

LUNA固件二进制文件在 [MIT许可证](LICENSE).
源代码是专有的，不会发布。

版权所有©2026西冈Sadahiko

______________________________________________________________________

### 第三方许可证

LUNA包含 **Lua 5.1**，根据MIT许可证分发：

> 版权所有©1994–2012 Lua.org，PUC Rio。
> 特此免费授予任何获得本软件和相关文档文件（“软件”）副本的人在不受限制的情况下处理软件的权限，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，以及允许获得软件的人这样做，但须符合以下条件：上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。

另请参见：https://www.lua.org/license.html

______________________________________________________________________

## 作者

**西冈贞彦**
github： [@OnStepNinja](https://github.com/OnStepNinja)