内容
# 占星术MCP服务器
一个提供占星术出生图表计算的MCP（模型上下文协议）服务器。给定出生日期、时间和地点，它可以计算行星位置、宫位、相位和关键图表点。
## 功能
- **完整的出生图表计算**：计算太阳、月亮、水星、金星、火星、木星、土星、天王星、海王星、冥王星、智神星和月节点的位置
- **宫位系统支持**：Placidus、Koch、Whole Sign、Equal、Campanus、Regiomontanus和Topocentric宫位系统
- **黄道系统**：支持热带和恒星黄道
- **相位计算**：主要相位（合相、对冲、三合、刑相、六合）和次要相位
- **关键图表点**：上升点（升星）、中天（MC）和图表统治者识别
- **三大要素**：强调太阳符号、月亮符号和上升点
## 安装
```bash
npm install
npm run build
```
## 使用
### 与Claude Desktop一起使用
将以下内容添加到Claude Desktop配置（`claude_desktop_config.json`）：
```json
{
"mcpServers": {
"astrology": {
"command": "node",
"args": ["/path/to/astro-mcp/build/index.js"]
}
}
}
```
### 可用工具
#### `get_birth_chart`
计算完整的出生图表。
**参数：**
- `year`（数字）：出生年份（1900-2100）
- `month`（数字）：出生月份（1-12）
- `day`（数字）：出生日期（1-31）
- `hour`（数字）：24小时格式的出生时间（0-23）
- `minute`（数字）：出生分钟（0-59）
- `latitude`（数字）：出生地点纬度（-90至90）
- `longitude`（数字）：出生地点经度（-180至180）
- `houseSystem`（字符串，可选）：使用的宫位系统（默认："placidus"）
- `zodiac`（字符串，可选）：黄道系统（默认："tropical"）
**示例：**
```json
{
"year": 1990,
"month": 6,
"day": 15,
"hour": 14,
"minute": 30,
"latitude": 40.7128,
"longitude": -74.006
}
```
#### `get_zodiac_info`
获取关于黄道十二宫的详细信息。
**参数：**
- `sign`（字符串）：十二宫之一：白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座
#### `get_aspect_info`
获取关于占星术相位的详细信息。
**参数：**
- `aspect`（字符串）：相位之一：合相、对冲、三合、刑相、六合、 inconjunction、 quintile、 semisextile、 semisquare、 sesquiquadrate
## 图表组件
### 行星/点（演员）
- **太阳**：核心身份、自我、目的
- **月亮**：情绪、滋养、内心世界
- **水星**：沟通、思维过程
- **金星**：爱情、人际关系、价值观
- **火星**：行动、能量、驱动力
- **木星**：成长、运气、扩张
- **土星**：纪律、挑战、结构
- **天王星**：创新、反叛、突然变化
- **海王星**：梦想、直觉、灵性
- **冥王星**：转变、力量、重生
- **北节点**：人生目的、命运
- **南节点**：过去的业力、天赋
- **智神星**：治愈、伤口、智慧
### 宫位（生活领域）
1. 个性、外貌（上升点）
2. 财务、自我价值
3. 沟通、兄弟姐妹
4. 家、家庭
5. 创造力、浪漫
6. 健康、日常工作
7. 伙伴关系、婚姻
8. 转变、共享资源
9. 高等教育、哲学
10. 职业、声誉（中天）
11. 友谊、社区
12. 潜意识、灵性
### 相位（行星关系）
- **合相（0°）**：能量融合
- **对冲（180°）**：紧张、需要平衡
- **三合（120°）**：和谐、流动
- **刑相（90°）**：挑战、通过摩擦成长
- **六合（60°）**：机会、合作
## 依赖项
- `@modelcontextprotocol/sdk`：MCP SDK，用于服务器实现
- `circular-natal-horoscope-js`：占星术计算库
- `zod`：模式验证
## 许可证
ISC
