ERUX Astrology & Ephemeris Engine

ERUX 占星与星历 MCP 服务

面向 ERUX 的官方 Model Context Protocol（MCP） 服务——高精度天文星历与双黄道占星智能引擎。

将 Claude Desktop、Cursor、Windsurf、Open-WebUI、LibreChat 或自主 Agent 框架直接连接到确定性占星计算，无需编译 C 星历库，也无需运行本地 Python 后台进程。

---

核心功能

• 高精度星历计算：提供太阳、月亮、火星、水星、木星、金星、土星、罗睺、计都、天王星、海王星、冥王星和凯龙星的亚角秒级坐标。
• 混合洞察模型（双黄道解耦）：同时评估西方热带黄道 Placidus 宫制（心理与性情构成）和吠陀恒星黄道 Lahiri 宫制（业力时机与 Dasha 时期）。
• 120 年 Parashara Vimshottari 时间线：涵盖多层级的 Mahadasha、Antardasha 和 Pratyantardasha 层级，日期边界精确到小时。
• 实时行运星盘：持续追踪行运行星与本命星盘宫头之间的关系，并提供结构化的行运相位预测。
• 地心 24 Hora 与择时引擎：依据当地日出和日落动态计算行星时（Hora），并提供 Rahu Kaal、Yamaganda、Gulika 和 Abhijit Muhurta。
• 古典吠陀瑜伽识别：通过算法识别 Raja、Dhana、Pancha Mahapurusha 和 Gaja Kesari 瑜伽，并说明触发瑜伽的行星。
• 交互式星盘轮盘生成：工具会自动返回交互式星盘轮盘 URL（https://erux.ai/chart?id=...）和渲染后的 PNG 预览。

---

全渠道机器人生态与社区

ERUX 在其 MCP 服务、Web 应用和聊天集成之间提供完全一致的命令：

平台	渠道 / 访问方式	功能
MCP Server	https://api.erux.ai/mcp	直接集成 Claude、Cursor、Windsurf、Open-WebUI 和 AI Agent
Smithery	在 Smithery 上查看	一键 CLI 安装程序（npx -y @smithery/cli run @akash-agl92/erux_mcp --client claude）
MCPRush	在 MCPRush 上查看	精选的全球 MCP 目录列表，提供直接的客户端配置
Discord Bot	添加到 Discord 服务器	交互式斜杠命令：/chart、/horoscope、/dasha、/yogas、/ask
Discord Community	加入社区	占星师社区讨论、版本更新和开发者支持
ChatGPT	OpenAI 插件（审核中）	直接通过对话合成占星命盘、Vimshottari Dasha 和行运
WhatsApp	在 WhatsApp 上聊天	即时生成本命盘轮盘、每日 hora 时间表，并通过对话问答了解行运
Instagram	@eruxaistro	通过私信进行占星咨询、接收行运提醒和可视化命盘卡片
Messenger	m.me/eruxai	全渠道 Facebook Messenger 机器人，所有核心星历工具均完全一致
Web Platform	erux.ai	完整的可视化交互式轮盘、多重分盘图（D1–D60）和行运

---

快速开始：添加到 MCP 客户端

ERUX 以远程 Streamable HTTP（SSE）服务的形式运行。无需本地安装软件包、运行 pip install 或使用 npx 编译。

1. Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

通过 mcp-remote 使用（可选的 stdio 桥接）： 如果你的客户端必须使用 stdio 进程：

{
  "mcpServers": {
    "erux-astrology": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.erux.ai/mcp"]
    }
  }
}

---

2. Cursor IDE

添加到 .cursor/mcp.json（或通过 Cursor 设置 > 功能 > MCP 添加）：

{
  "mcpServers": {
    "erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

---

3. Windsurf（Codeium）

添加到你的 mcp_config.json：

{
  "mcpServers": {
    "erux-astrology": {
      "serverUrl": "https://api.erux.ai/mcp"
    }
  }
}

---

4. Open-WebUI 和 LibreChat

前往 管理面板 > 设置 > 工具 / MCP，并注册远程 SSE 端点：

• 服务名称：erux-astrology
• 服务 URL：https://api.erux.ai/mcp
• 传输方式：sse / streamable-http

---

5. Smithery CLI（一键自动安装）

使用 Smithery 自动配置 ERUX 并将其连接到 Claude Desktop：

npx -y @smithery/cli run @akash-agl92/erux_mcp --client claude

---

6. Python / LangChain / CrewAI Agent

from mcp import ClientSession
from mcp.client.sse import sse_client

async def run_astrology_agent():
    async with sse_client("https://api.erux.ai/mcp") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # List available tools
            tools = await session.list_tools()
            print([tool.name for tool in tools.tools])
            
            # Calculate birth chart
            result = await session.call_tool("calculate_chart", {
                "date": "1992-10-14",
                "time": "14:30",
                "city": "Austin, Texas",
                "system": "hybrid"
            })
            print(result)

---

工具目录

ERUX 向宿主模型提供 6 个确定性工具：

1. calculate_chart

计算个人出生星盘或国家世俗星盘。

• 参数：
  • date（string，YYYY-MM-DD）：出生日期或国家建国日期。
  • time（string，HH:MM）：24 小时制出生时间（如果未知，默认为太阳正午 12:00）。
  • city（string）：出生或建国所在城市。
  • country（可选 string）：用于消除城市名称歧义的国家。
  • system（可选 string）：'hybrid'（默认）、'vedic' 或 'western'。
• 输出：精确的行星黄经、逆行状态、纳克沙特拉、宫头、当前大运周期，以及交互式 chart_ui_url。

2. get_horoscope

生成行运星盘、每日 24-Hora 行星时段和行运行星相位预测。

• 参数：
  • birth_date（string，YYYY-MM-DD）：用户的本命出生日期。
  • birth_city（string）：本命出生城市。
  • birth_time（optional string，默认值为 '12:00'）：本命出生时间。
  • current_city（optional string）：迁居后的城市，用于计算当地地平坐标。
  • cadence（optional string）：'daily'（Hora 和 Panchang）、'weekly'、'monthly'、'yearly'（太阳返照）。
  • target_date（optional string）：未来预测的目标日期。
• 输出：贴近现实的策略指导、地平坐标 24-Hora 时段表、Rahu Kaal、行运预测，以及交互式行运星盘链接。

3. calculate_dasha

计算 120 年的 Parashara Vimshottari 行星时间线。

• 参数：
  • date（string，YYYY-MM-DD）：本命出生日期。
  • time（string，HH:MM）：24 小时制出生时间。
  • city（string）：出生城市。
  • target_date（optional string）：用于查看当前有效子周期的目标日期。
• 输出：120 年的 Mahadasha 时间线，包含完整的 Antardasha 和 Pratyantardasha 起止日期。

4. get_yogas

识别经典吠陀瑜伽组合和当前有效的行星组合。

• 参数：
  • date（string，YYYY-MM-DD）：本命出生日期。
  • time（string，HH:MM）：24 小时制出生时间。
  • city（string）：出生城市。
• 输出：检测到的瑜伽组合（Raja、Dhana、Gajakesari、Mahapurusha）、强度评估和行星触发因素。

5. ask_astrology_guidance

结合宫位象征和 Karaka，对人生支柱进行情境化综合分析。

• 参数：
  • prompt（string）：用户的人生问题（例如职业转型、搬迁时机）。
  • birth_date（string）：本命出生日期。
  • birth_city（string）：本命出生城市。
• 输出：基于相关宫位和 Karaka 分析的、有依据的占星框架指导。

6. get_interpretation

对人生核心支柱进行全面深入的分析。

• 参数：
  • pillar（string）：'career'、'love'、'wealth'、'health' 或 'spirituality'。
  • date（string）：本命出生日期。
  • city（string）：本命出生城市。
• 输出：结合本命星位、Dasha 周期和行运影响的详细分析。

---

示例提示词

向连接了 MCP 的模型提问：

• “我当前的 Vimshottari Mahadasha 和 Antardasha 是什么？我于 1992 年 10 月 14 日下午 2:30 出生在德克萨斯州奥斯汀。”
• “展示我的完整出生星盘，并计算我的吠陀瑜伽组合。”
• “今天在伦敦进行商务谈判，哪些天文 Hora 时段最佳？”
• “计算法国的国家世俗星盘，并总结其主要行星位置。”
• “我计划下个月转行。根据我的本命星位，目前有哪些行星行运？”

---

安全与架构

• 托管远程端点：所有天文计算均在安全、经过加固的 ERUX 云基础设施（api.erux.ai）上执行。
• 不在本地执行代码：连接 ERUX 不会在你的本地计算机上执行任意二进制文件或脚本。
• 无需 API 密钥：标准查询无需身份验证或预先提供 API 密钥即可使用公共 MCP 端点。
• 只读且幂等：所有工具均标注为只读且幂等，可确保在企业 Agent 工作流中安全执行。

---

资源与链接

• Web 应用：https://erux.ai
• 开发者 MCP 文档：https://erux.ai/developers/mcp
• Discord 机器人：邀请机器人
• 社区 Discord：加入社区
• 官方 MCP 注册表：注册表链接

---

许可证

此代码仓库及其配置架构采用 MIT License 授权。 通过 ERUX API 提供的计算结果和数据受 ERUX 服务条款约束。