内容
# RishiAI MCP 服务器
[](https://pypi.org/project/rishi-ai-mcp/)
[](https://github.com/adarshj322/rishi-ai-mcp/actions/workflows/ci.yml)
[](https://pypi.org/project/rishi-ai-mcp/)
[](https://opensource.org/licenses/MIT)
一个 [模型上下文协议](https://modelcontextprotocol.io/) 服务器，提供 **吠陀占星术工具**，由 [DashaFlow](https://github.com/adarshj322/dashaflow) 计算引擎驱动。
与 **任何MCP兼容的客户端** 配合使用 — VS Code Copilot, Cursor, Claude Desktop, Claude Code, Gemini CLI, Codex, Antigravity, OpenCode, OpenClaw, Pi 代理，或任何自定义应用程序。
https://github.com/user-attachments/assets/9c183b94-bb54-4af6-867c-fa3daeef2d03
## 安装
```bash
pip install rishi-ai-mcp
```
## 快速入门
```bash
rishi-ai-mcp # 控制台入口点（安装后）
python rishi_ai_mcp.py # 或直接从源代码运行
```
通过 **stdio** 进行通信。任何MCP客户端都可以启动子进程并使用MCP进行通信，无需IDE。
---
## 设置
克隆此仓库到工作空间中，获取MCP配置和RishiAI代理规则：
```bash
git clone https://github.com/adarshj322/rishi-ai-mcp.git
```
仓库中包含三种IDE的预配置：
### VS Code / GitHub Copilot
- `.vscode/mcp.json` — 自动配置MCP服务器
- `.github/copilot-instructions.md` — RishiAI角色（始终在线）
- `.agents/skills/*/SKILL.md` — 14个工作流技能（自动触发主题或通过 `/skill-name` 调用）
VS Code Copilot 读取 `.github/copilot-instructions.md` 以获取始终在线的说明，并从 `.agents/skills/` 读取技能。只需打开克隆的文件夹，工具、角色和技能就会生效。
### Cursor
- `.cursor/mcp.json` — 自动配置MCP服务器
- `.cursor/rules/rishi-ai.mdc` — RishiAI角色（始终在线的核心规则）
- `.agents/skills/*/SKILL.md` — 14个工作流技能（共享，Cursor原生读取 `.agents/skills/`）
在Cursor中打开克隆的文件夹，工具、角色和技能就会生效。
### Antigravity
- `.agents/rules/rishi-ai.md` — RishiAI角色（始终在线）
- `.agents/skills/*/SKILL.md` — 14个工作流技能
- `.agents/workflows/*.md` — 14个斜杠命令工作流
Antigravity 原生读取 `.agents/`。在 Antigravity 设置中配置 MCP 服务器：
```
command: uvx
args: rishi-ai-mcp
```
### 其他MCP客户端（Claude Desktop, Claude Code, Gemini CLI等）
任何MCP兼容的客户端都可以使用相同的服务器连接。在客户端的MCP配置中添加：
```json
{
"mcpServers": {
"vedic-astrology": {
"command": "uvx",
"args": ["rishi-ai-mcp"]
}
}
}
```
对于RishiAI角色，使用 `system_prompt.md` 作为参考，并根据客户端的指令格式进行调整。
### 独立/自定义客户端
```python
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
params = StdioServerParameters(command="uvx", args=["rishi-ai-mcp"])
async with stdio_client(params) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool("cast_vedic_chart", {
"dob": "1990-04-15", "time": "14:30",
"lat": 28.6139, "lon": 77.2090, "timezone": "Asia/Kolkata"
})
print(result)
```
---
## MCP 工具
### `cast_vedic_chart`
生成完整的吠陀出生图表。
| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `dob` | 字符串 | 出生日期 — `"YYYY-MM-DD"` |
| `time` | 字符串 | 出生时间 — `"HH:MM"`（24小时制） |
| `lat` | 浮点数 | 出生纬度（例如 `28.6139` 代表德里） |
| `lon` | 浮点数 | 出生经度（例如 `77.2090` 代表德里） |
| `timezone` | 字符串 | IANA 时区（例如 `"Asia/Kolkata"`） |
| `query_date` | 字符串 | 可选 — 用于达沙查询的日期，默认为今天 |
**返回：** JSON 包含 `metadata`、`panchang`、`lagna`（带有 D2–D60 星座）、`planets`（带有尊贵度、燃烧度、Shadbala、所有 14 个 Varga 星座、相位）、`dashas`（5 级：Maha/Antar/Pratyantar/Sukshma/Prana + 时间线）、`yogas`（24 种类型）、`ashtakavarga`（SAV + BAV + Prashtara）、`jaimini_karakas`、`shadbala`（带有 Ishta/Kashta Phala）、`bhava_chalit`、`avasthas`、`kaal_sarpa`、`graha_yuddha`、`gandanta`、`arudha_padas`（A1–A12）、`upapada`、`karakamsha`。
### `cast_transit_chart`
计算叠加在出生图表上的行星 transit。
| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `transit_date` | 字符串 | 计算 transit 的日期 — `"YYYY-MM-DD"` |
| `dob` | 字符串 | 出生日期 — `"YYYY-MM-DD"` |
| `time` | 字符串 | 出生时间 — `"HH:MM"`（24小时制） |
| `lat` | 浮点数 | 出生纬度 |
| `lon` | 浮点数 | 出生经度 |
| `timezone` | 字符串 | 可选 — 默认 `"Asia/Kolkata"` |
**返回：** JSON 包含 transit `planets`（星座、度数、纳克沙特拉、`sav_points`、从 Lagna/Moon 的宫位）、`sade_sati` 状态和阶段，以及 `rahu_ketu_axis`。
### `calculate_compatibility_tool`
计算 16 个因素的兼容性 + 库贾多沙。人员 1 = 男性，人员 2 = 女性。
| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `dob1`, `time1`, `lat1`, `lon1`, `tz1` | 各种 | 人员 1（男性）的出生详情 |
| `dob2`, `time2`, `lat2`, `lon2`, `tz2` | 各种 | 人员 2（女性）的出生详情 |
**返回：** 8 个 Ashtakoot kutas（36 分）、额外 kutas（Mahendra、Stree Deergha、Vedha、Rajju、BadConstellations、LagnaHouse7、SexEnergy）、例外逻辑和库贾多沙分析。
### `check_muhurtha_tool`
评估给定日期/时间是否适合特定活动（选举占星术）。
| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `activity` | 字符串 | 以下之一：`marriage`、`travel`、`business`、`education`、`house_entry`、`medical` |
| `date` | 字符串 | 评估日期 — `"YYYY-MM-DD"` |
| `time` | 字符串 | 评估时间 — `"HH:MM"`（24小时制） |
| `lat` | 浮点数 | 位置纬度 |
| `lon` | 浮点数 | 位置经度 |
| `timezone` | 字符串 | IANA 时区字符串 |
**返回：** JSON 包含 `verdict`、`score`、`positive_factors`、`negative_factors`、`panchang_suddhi` 和 `marriage_doshas`（适用于婚姻活动）。
### `analyze_career_chart`
使用第 10 宫、D10 Dashamsha 和行星意义分析职业潜力。
| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| `dob` | 字符串 | 出生日期 — `"YYYY-MM-DD"` |
| `time` | 字符串 | 出生时间 — `"HH:MM"`（24小时制） |
| `lat` | 浮点数 | 出生纬度 |
| `lon` | 浮点数 | 出生经度 |
| `timezone` | 字符串 | IANA 时区字符串 |
**返回：** JSON 包含 `tenth_house` 信息、`d10_indicators`、`career_themes` 和 `strength_factors`。
---
## RishiAI 代理角色
仓库中包含 **RishiAI** 角色 — 一个使用 BPHS 方法解释图表数据的吠陀占星术 AI。
| IDE | 始终在线规则 | 技能 |
|-----|---------------|--------|
| **VS Code Copilot** | `.github/copilot-instructions.md` | `.agents/skills/*/SKILL.md`（12 个技能） |
| **Cursor** | `.cursor/rules/rishi-ai.mdc` | `.agents/skills/*/SKILL.md`（12 个技能） |
| **Antigravity** | `.agents/rules/rishi-ai.md` | `.agents/skills/*/SKILL.md` + `.agents/workflows/*.md` |
| **其他客户端** | 从 `system_prompt.md` 适配 | 从 `.agents/workflows/` 适配工作流步骤 |
所有 IDE 都共享来自 `.agents/skills/` 的技能，使用 [Agent Skills](https://agentskills.io/) 开放标准。
### 工作流
| 命令 | 描述 |
|---------|-------------|
| `/full-reading` | 完整的出生图表阅读 |
| `/career-analysis` | 职业和专业指导 |
| `/marriage-analysis` | 婚姻时机和兼容性 |
| `/relationship-analysis` | 关系动态 |
| `/children-analysis` | 子女和后代 |
| `/finance-analysis` | 财富和财务前景 |
| `/health-analysis` | 健康趋势和补救措施 |
| `/education-analysis` | 教育和学习 |
| `/spiritual-analysis` | 精神路径和实践 |
| `/muhurtha-analysis` | 选举占星术时机 |
| `/physicalIntimacy-analysis` | 身体兼容性 |
| `/geopolitics-analysis` | 世俗占星术 |
| `/past-life-analysis` | 前世 karma 和 karmic 债务 |
| `/spouse-profiling` | 详细的配偶蓝图 — 外貌、性格、原型 |
---
## 架构
```
rishi_ai_mcp.py MCP 入口点 — 5 个工具，可通过 pip 安装
└── dashaflow (pip) 计算引擎
├── vedic_calculator 瑞士星历核心
├── constants 十二星座、纳克沙特拉、尊贵度
├── nakshatra 纳克沙特拉查找
├── panchang 替身、瓦拉、瑜伽、卡拉那
├── yoga 24 种瑜伽类型 + 卡尔萨帕、格拉哈尤达、甘丹塔
├── dasha 维姆绍塔里 5 级
├── dignity 尊贵度、燃烧度、迪格巴拉
├── ashtakavarga SAV、BAV、普拉什塔拉
├── jaimini 卡拉卡斯、阿鲁达帕达斯、乌帕帕达、卡拉坎沙
├── shadbala 六倍力量 + 伊什塔/卡什塔法拉
├── matchmaking 16 个因素兼容性 + 库贾多沙
├── muhurtha 选举占星术
└── career D10 职业分析
.vscode/mcp.json VS Code Copilot MCP 配置
.github/
└── copilot-instructions.md 始终在线规则（VS Code Copilot）
.cursor/
├── mcp.json Cursor MCP 配置
└── rules/rishi-ai.mdc 始终在线核心规则（Cursor）
.agents/ 所有 IDE 共用
├── rules/rishi-ai.md 始终在线代理规则（Antigravity）
├── skills/ 14 个工作流技能（SKILL.md per 文件夹）
└── workflows/ 14 个斜杠命令工作流（Antigravity）
system_prompt.md 通用参考提示（适用于其他客户端）
```
## 先决条件
- **Python 3.10+**
- **dashaflow** — 自动作为依赖项安装
- **mcp** — 自动作为依赖项安装
## 许可证
MIT
