TianJi Astrology

TianJi Astrology MCP 服务

面向 AI Agent 的计算优先占星工具。 提供真实的星历级行星位置、宫位和相位，而非泛泛的太阳星座内容。

由 TianJi Astrology 基于 kerykeion 6.x（libephemeris 引擎）构建。传输方式：流式 HTTP（MCP 规范）。

在线端点： https://mcp.tianji-astrology.com/mcp

为什么选择此服务

大多数占星 MCP 服务只是包装星座运势文本。TianJi 会计算真实星盘：

• Swiss-ephemeris 级别的行星黄经、逆行状态和宫头（通过 kerykeion/libephemeris）
• 完整的 12 宫位置，并为每颗行星确定其宫头所在的宫位
• 使用标准容许度计算主要相位（合相、六分相、四分相、三分相、对分相）
• 输出确定性结果，供 Agent 推理使用——整个流程中不包含由大模型生成的“解读”

工具

compute_natal_chart

根据日期、时间和地点计算本命（出生）星盘。

参数：name、year、month、day、hour（默认为 12）、minute（默认为 0）、city、nation、lng、lat、tz_str。

返回 JSON：从太阳到冥王星的行星位置（星座、度数、宫位、逆行状态）、上升点/中天、宫头，以及包含精确角距的相位列表。

get_current_transits

今日星象：当前十个天体的行星位置及逆行标记。无需参数。

get_sign_profile

星座参考信息：元素、模式、守护行星（传统 + 现代）、日期范围。参数：sign（例如 "Scorpio"）。

使用方法

远程（托管）

该服务通过 https://mcp.tianji-astrology.com/mcp 公开运行（流式 HTTP 传输）。将支持远程服务的任意 MCP 客户端指向此 URL 即可——使用参考工具无需 API 密钥。

Claude Desktop / Claude Code（claude mcp add）：

claude mcp add --transport http tianji https://mcp.tianji-astrology.com/mcp

Cursor / 其他客户端：添加一条服务器配置，类型为 http（或 streamable-http），并填入上述 URL。

自托管

docker build -t tj-mcp .
docker run -p 8033:8033 tj-mcp

或直接使用 Python：

pip install fastmcp kerykeion
python server.py

数据与隐私

所有计算均在服务端本地完成。出生数据仅用于计算星盘，绝不会被存储或记录日志。

许可证

MIT——请参阅 LICENSE。

---

TianJi Astrology：通过计算实现个性化西方占星。https://tianji-astrology.com