用途
Astral MCP 是一个面向 AI 智能体的占星计算 MCP 服务器，将出生数据转化为完整、经过精度审计的占星解读。它定位为本地优先、无状态的计算工具，不存储任何数据、不持有凭证，除可选的地理编码外，所有工具均可完全离线运行。项目由 David Mosiah 构建，占星引擎移植自 Alkhemia 应用，采用 MIT 许可。
主要能力
服务器提供以下工具：
- astral_compute_natal_chart：完整本命盘，默认进行精度审计。
- astral_current_transits：当前及即将到来的行运，并附带月相。
- astral_synastry：比较两张星盘（和谐度/化学反应/沟通/成长）。
- astral_moon_phase：任意日期的月相、星座与光照度。
- astral_search_birthplace：将地点地理编码为纬度/经度/时区。
- astral_demo：无需输入的完整示例星盘。
- astral_capabilities：服务器支持与不支持的内容。
- astral_data_inventory：数据域与推荐首次调用。
- astral_agent_manifest：安装与使用规则。
- astral_connection_status：通过示例星盘与双引擎审计进行健康检查。
每张本命盘均附带精度审计：主引擎（circular-natal-horoscope-js）计算星盘，验证引擎（astronomy-engine）独立重新推导每颗行星的黄经。仅当所有行星在容差内一致且落入相同星座时才判定为已验证。在覆盖 1945–2010 年、六个时区的内置精度套件中，跨引擎最大分歧低于 0.01°。
使用方式
零配置安装：在 MCP 客户端（Claude Desktop、Cursor、Hermes 等）中配置 npx -y astral-mcp 即可立即调用，无需 API 密钥、OAuth 或账户。也可直接运行。默认使用 stdio 传输；可选 Streamable HTTP（v2 无状态），仅限回环，无会话 ID，JSON 响应。环境变量：ASTRAL_MCP_HOST、ASTRAL_MCP_PORT、ASTRAL_MCP_TRANSPORT=http。
隐私模式：三个星盘工具（本命盘、行运、合盘）接受 privacy_mode 参数，用于控制载荷详细程度：full（默认，包含每颗行星的精度审计）、structured（相同结构，去除冗余/可推导字段）、summary（仅高信号要点，如发光体+上升点、星盘签名、主要相位）。完整的格林威治本命盘载荷约 6.9 KB，summary 约 1.2 KB（减少约 80%），便于智能体节省 token。
适用场景
适合需要为 AI 智能体提供可信、即时占星计算的场景，例如：查询本命盘、查看本周重大行运、进行合盘兼容性分析、查询月相。智能体可先调用 astral_search_birthplace 解析出生地，再调用 astral_compute_natal_chart。
限制与注意事项
- 出生时间可选，但若省略则默认中午：行星星座仍然准确，但上升点与宫位不可靠。
- 应传入出生地时区，而非调用者时区；astral_search_birthplace 会返回时区。
- 唯一的可选网络调用是 astral_search_birthplace（OpenStreetMap），仅发送传入的地点名称字符串。
- 项目声明不存储任何数据、不持有秘密。
- 计算核心位于 src/engine/，移植自 Alkhemia，需保持无框架依赖；开发规则与测试门禁（npm test）见 AGENTS.md。
- 安全策略详见 SECURITY.md，许可详见 LICENSE。
- 关于协议模式的更多说明、确定性星盘计算与模型解读的分离、推荐智能体工作流以及精度/隐私边界，可参阅相关文档（What Is an Astrology MCP Server? 等）。
