使用说明
夜间mcp
MCP（模型上下文协议）服务器 夜曲 占星术API。
为人工智能代理提供完整的占星技能：出生图表、过境、通联、进程、返回和图表图像渲染——总共20个工具。
工具
计算（通过夜间计算API）
| 工具 | 说明 |
|---|---|
calculate_natal_chart |
纳塔尔（出生）图：行星、宫位、相位 |
calculate_synastry |
两个图表之间的交叉点 |
calculate_composite |
一对夫妇的综合/戴维森图 |
calculate_transits |
当前向出生图过渡 |
calculate_progressions |
次级级数或太阳弧 |
calculate_returns |
太阳或月球返回图 |
calculate_directions |
主方向/太阳弧方向 |
calculate_eclipses |
日期范围内的日食/月食 |
calculate_ingresses |
行星星座进入某个日期范围 |
calculate_fixed_stars |
恒星与本星球结合 |
calculate_arabic_parts |
阿拉伯零件/批次 |
calculate_dignities |
基本尊严（统治、提升等） |
calculate_antiscia |
Antiscia和contra Antiscia |
calculate_declinations |
下降和平行 |
calculate_harmonics |
谐波图 |
calculate_special_points |
月球节点，莉莉丝，赛琳娜 |
calculate_rectification |
从生活事件中纠正出生时间 |
图表渲染（通过夜间图像API）
| 工具 | 说明 |
|---|---|
render_natal_chart |
计算+将出生图渲染为PNG |
render_transit_chart |
两轮车：出生（内）+过境（外） |
render_synastry_chart |
两轮车：1人（内）+2人（外） |
设置
先决条件
- 包子 运行时
- 访问Nocturna API（需要服务令牌）
安装
git clone https://github.com/eaprelsky/nocturna-mcp
cd nocturna-mcp
bun install
配置
复制 .env.example 到 .env 并填写您的API令牌：
cp .env.example .env
添加到克劳德代码
添加到您的 .mcp.json:
{
"mcpServers": {
"nocturna": {
"command": "bun",
"args": ["run", "/path/to/nocturna-mcp/server.ts"],
"env": {
"NOCTURNA_API_URL": "https://www.calc.nocturna.ru/api",
"NOCTURNA_SERVICE_TOKEN": "your_token",
"CHART_SERVICE_URL": "https://www.img.nocturna.ru",
"NOCTURNA_IMAGE_SERVICE_TOKEN": "your_image_token"
}
}
}
}
示例用法
Calculate Lady Gaga's natal chart:
→ calculate_natal_chart(date="1986-03-28", time="09:53:00", latitude=40.7128, longitude=-74.0060, timezone="America/New_York")
Render the chart as an image:
→ render_natal_chart(date="1986-03-28", time="09:53:00", latitude=40.7128, longitude=-74.0060, timezone="America/New_York", person_name="Lady Gaga")
Check transits for today:
→ calculate_transits(natal_date="1986-03-28", natal_time="09:53:00", natal_latitude=40.7128, natal_longitude=-74.0060, transit_date="2026-03-28")
许可证
麻省理工学院