关于 caelus-mcp
caelus-mcp 是基于 Caelus TypeScript 引擎的占星计算 MCP 服务，面向需要星盘、行运、时序技法、吠陀占星计算及可引用星盘事实的用户和开发者。项目称其为洁净室实现，不含 Swiss Ephemeris 代码或星历文件。
主要功能
- 01星盘与行运计算
- 02合盘、事件与日食月食
- 03希腊化时序技法
- 04吠陀占星方法
- 05可引用的星盘事实与天空视图帧
适用场景
- 01生成占星星盘
- 02查看行运或日食月食
- 03计算星盘之间的合盘
- 04生成可供引用的星盘事实
MCP 相关
`caelus-mcp` 软件包提供星盘、行运、合盘、事件和日食月食相关的 MCP 工具。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
服务地址
https://www.ephemengine.com/api/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http heavyblotto-caelus https://www.ephemengine.com/api/mcpCursor.cursor/mcp.json
{"mcpServers":{"heavyblotto-caelus":{"type":"http","url":"https://www.ephemengine.com/api/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"heavyblotto-caelus":{"type":"http","url":"https://www.ephemengine.com/api/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"heavyblotto-caelus":{"type":"http","url":"https://www.ephemengine.com/api/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"heavyblotto-caelus":{"serverUrl":"https://www.ephemengine.com/api/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
35| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lat | number | 是 | 纬度，北纬为正 |
| lon | number | 是 | 经度，东经为正（美洲为负） |
| date | string | 是 | UTC 日期时间，ISO 8601 格式，例如 1990-06-10T14:30:00Z。请先将当地出生时间转换为 UTC。 |
| grid | enum | 否 | 规范网格（搭配 output:'canonical'）：arcsec（默认）、milliarcsec、centideg、dms（[deg,min,sec] 三元组）或 accuracy（将每个天体舍入到其经过验证的测量精度；这是跨平台内容寻址时最具可移植性的选项）arcsec | milliarcsec | centideg | dms | accuracy |
| output | enum | 否 | 'float'（默认）返回常规浮点数载荷。'canonical' 返回声明网格上的整数以及 sha256 摘要：在不同机器／浏览器／语言之间保持稳定，可用于缓存和去重哈希，精度忠实；星座／宫位／相位会根据量化值重新推导，因此显示的数字与事实始终一致float | canonical |
| zodiac | enum | 否 | tropical（默认）或 sidereal:<ayanamsa>tropical | sidereal:lahiri | sidereal:fagan_bradley | sidereal:krishnamurti | sidereal:raman | sidereal:yukteshwar | sidereal:galcent_0sag | sidereal:true_citra |
| remainders | enum | 否 | 当 output:'canonical' 时：同时返回余数集——量化时舍弃的亚量子级整数余数，按叶路径作为键，并绑定到载荷摘要。'auto' 会选择比基础网格精细一级的网格；也可指定细化网格（必须严格更精细）。余数可累积：composeRemainders(payload, remainders) 可精确重建更精细网格上的载荷。时间余数以整数微秒表示，距离余数以整数 nano-AU 表示auto | arcsec | milliarcsec |
| separation | enum | 否 | 相位分离：'longitude'（默认，黄道相位）或 'spatial'（真实大圆分离角，会考虑黄纬；对于月亮、冥王星以及远离黄道的天体，结果会有所不同）longitude | spatial |
| house_system | string | 否 | 宫位制（默认 placidus）。不区分大小写和空格；有效值：placidus、whole_sign、equal、porphyry、koch、regiomontanus、campanus、alcabitius、morinus、meridian、polich_page、vehlow（也支持 "whole sign" 等别名）。 |
详细介绍
Caelus
洁净室实现的占星计算单仓库。采用 MIT 许可，不含 Swiss Ephemeris 代码、AGPL 代码或星历文件。Caelus 可计算星历位置、星盘、事件、希腊化时期的时间技术、吠陀方法、可引用的星盘事实、用于图像提示词的天空视图帧，以及围绕这些功能的 MCP 工具。在线地址：ephemengine.com。
软件包
| 路径 | npm | 描述 |
|---|---|---|
packages/caelus | caelus | TypeScript 引擎（压缩后总计约 153 KB，无依赖） |
packages/caelus-mcp | caelus-mcp | MCP 服务：星盘、行运、比较盘、事件、日食和月食 |
packages/caelus-delineations-pd | — | 公共领域的解读语料库，以及 interpret() 的默认验证集 |
packages/birth | caelus-birth | 出生时间和地点 → UT（时区和夏令时解析） |
packages/wheel | caelus-wheel | React SVG 星盘轮，无运行时依赖 |
apps/web | — | Next.js 网站：演练场、验证、边缘 /api/chart |
caelus-starter | — | Next.js 入门应用（独立仓库） |
Python 参考引擎和数据拟合流水线位于 python/；它们生成系数数据和黄金测试样例，不属于运行时依赖。
文档
- ARCHITECTURE.md — 布局、持久性决策、产品策略
- MCP_SPEC.md — MCP 工具契约
- docs/gap-analysis.md — 与 Swiss Ephemeris 的比较（已于 0.5.0 版完成）
- docs/agents.md — 编码 Agent 基于 Caelus 构建时需注意的问题
- docs/releasing.md — 发布流程
快速开始
npm install
npm run build
npm test
npm run dev -w web
http://localhost:3000 — 在浏览器中查看实时星盘。
边缘 API：GET /api/chart?date=…&lat=…&lon=…。
分支
main— 稳定版发布dev— 正在进行的开发
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。