Ziwei Astrology MCP Server

MCP地图位置

提供方 smogievogie

地图位置 未标注 API Key 社区 / 第三方

Enables generation of detailed Chinese Ziwei Doushu (Purple Star) astrological charts with geographic location support and true solar time conversion. Provides tools for geocoding locations, converting Beijing time to apparent solar time, and creating comprehensive astrology readings based on birth information.

一句话选型结论

按资料字段整理

Ziwei Astrology MCP Server 属于地图位置类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类地图位置 传输方式未标注 鉴权API Key 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

地图位置
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
地址与路线

查地址、算路线、找附近地点。

位置检索

按区域筛门店、站点与设施。

地理数据

拉取经纬度、行政区等地理信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在地图位置场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ziwei Astrology MCP Server当前 未标注 未标注 支持远程部署 无 2026-05-17
MCP Server C2f246e3 20 stdio · 本地进程 本地部署 有 2026-05-17
OpenStreetMap MCP Server 12 stdio · 本地进程 本地部署 有 2026-05-18
Baidu Maps 10 stdio · 本地进程 本地部署 有 2026-05-17
Google Maps (google-maps-aa2563d3) 7 未标注 未标注 无 2026-05-17
generative-ai 未标注 stdio · 本地进程 本地部署 有 2026-04-17

服务器档案

地图位置
字段来自项目仓库与公开索引,中文说明由本站标注
提供方smogievogie上游标注的维护方 smogievogie
分类地图位置本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.2 KB
来自项目仓库与上游目录的原文,未做删改

iztro MCP 服务器

基于 iztro 的模型上下文协议 (MCP) 服务器 - 生成紫微斗数星盘,支持地理编码和真太阳时转换。

📹 演示视频

演示视频 - 8月15日

✨ 功能特性

  • 🌟 星盘生成: 根据出生信息生成详细的紫微斗数星盘
  • 🌍 地理编码服务: 使用高德地图API将地点名称转换为精确坐标
  • ⏰ 真太阳时转换: 采用天文算法计算高精度真太阳时
  • 🔌 MCP集成: 与MCP兼容客户端无缝集成
  • 🔒 安全配置: 支持环境变量和配置文件

🚀 快速开始

安装

全局安装(推荐)```bash

npm install -g ziwei_iztro-mcpserver


#### 本地安装```bash
npm i ziwei_iztro-mcpserver

配置

⚠️ 重要提示:使用前请配置您自己的API密钥!

方式一:环境变量(推荐)```bash

复制示例环境文件

cp .env.example .env

编辑 .env 文件并添加您的高德地图API密钥

echo "AMAP_API_KEY=your_actual_api_key_here" > .env


#### 方式二:配置文件```bash
# 复制示例配置文件
cp iztro-mcp-config.example.json iztro-mcp-config.json

# 编辑配置文件并添加您的API密钥

获取高德地图API密钥

  1. 访问 高德开放平台
  2. 注册账号并登录
  3. 创建应用,选择"Web服务"类型
  4. 获取您的API密钥

自动化设置(推荐)```bash

运行交互式设置脚本

npm run setup


这将引导您完成配置过程并创建必要的文件。

## 📋 使用方法

### 作为独立服务器```bash
# 启动MCP服务器
ziwei_iztro-mcpserver
# 或者
npm start

与MCP客户端集成

添加到您的MCP客户端配置中:```json
{
"mcpServers": {
"iztro": {
"command": "npx",
"args": ["ziwei_iztro-mcpserver"]
}
}
}


或者本地安装:```json
{
  "mcpServers": {
    "iztro": {
      "command": "node",
      "args": ["/path/to/ziwei_iztro-mcpserver/dist/index.js"]
    }
  }
}

🛠️ 可用工具

1. geocode_location

将地点名称转换为精确坐标。

参数:
- location (string, 必需): 地点名称,例如:"安徽省合肥市庐江县金牛镇"

返回:```json
{
"location": "安徽省合肥市庐江县金牛镇",
"longitude": 117.123456,
"latitude": 31.654321,
"formatted_address": "安徽省合肥市庐江县金牛镇"
}


### 2. `convert_to_apparent_solar_time`

根据地理位置将北京时间转换为真太阳时。

**参数:**
- `beijingTime` (string, 必需): 北京时间,格式为 YYYY-MM-DD HH:mm:ss
- `longitude` (number, 必需): 经度(东经为正,西经为负)
- `latitude` (number, 可选): 纬度(北纬为正,南纬为负)

**返回:**```json
{
  "beijing_time": "2024-01-01 12:00:00",
  "longitude": 117.123456,
  "latitude": 31.654321,
  "apparent_solar_time": "2024-01-01 12:08:30"
}

3. generate_astrolabe

生成紫微斗数星盘,支持基于地点的真太阳时转换。

参数:
- birthday (string, 必需): 出生日期,格式为 YYYY-MM-DD
- birthTime (number, 必需): 出生时辰 (0-11),其中 0=子时,1=丑时,以此类推
- gender (string, 必需): 性别,'男' 或 '女'
- calendarType (string, 可选): 日历类型,'solar' 或 'lunar',默认为 'solar'
- isLeapMonth (boolean, 可选): 是否为闰月(仅农历有效)
- language (string, 可选): 输出语言,支持 'zh-CN', 'zh-TW', 'en-US', 'ja-JP', 'ko-KR', 'vi-VN'
- location (string, 可选): 出生地点,用于真太阳时转换

返回:
完整的星盘数据,如果提供了地点参数,还包含地点处理信息。

🛠️ 开发

前置要求

  • Node.js >= 16.0.0
  • npm 或 yarn
  • TypeScript 5.0+

本地开发```bash

克隆仓库

git clone https://github.com/smogievogie/ziwei_iztro-mcpserver.git
cd ziwei_iztro-mcpserver

安装依赖

npm install

构建项目

npm run build

运行设置脚本

npm run setup

启动开发服务器

npm run dev


### 测试```bash
# 使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector node dist/index.js

📚 技术细节

真太阳时计算

  • 基于 Jean Meeus《天文算法》
  • 考虑地球轨道椭圆性和轴倾斜
  • 与天文年历相比精度在3秒内
  • 支持早子时和晚子时区分

地理编码服务

  • 由高德地图API提供支持
  • 高精度坐标转换
  • 支持中国境内详细地址解析
  • 地理编码失败时自动回退到原始时间

🤝 贡献

欢迎贡献!请随时提交Pull Request。

开发指南

  1. Fork 本仓库
  2. 创建 功能分支:git checkout -b feature/amazing-feature
  3. 提交 您的更改:git commit -m 'Add amazing feature'
  4. 推送 到分支:git push origin feature/amazing-feature
  5. 提交 Pull Request

代码规范

  • 使用TypeScript确保类型安全
  • 遵循ESLint配置
  • 添加适当的单元测试
  • 根据需要更新文档

📄 许可证

本项目采用MIT许可证 - 详见 LICENSE 文件。

🙏 致谢

  • iztro - 紫微斗数核心库
  • MCP SDK - 模型上下文协议TypeScript SDK
  • 高德地图API - 地理编码服务提供商

📞 支持

  • 问题反馈: GitHub Issues
  • 讨论: GitHub Discussions
  • 文档: 项目Wiki

为紫微斗数爱好者用❤️制作

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Ziwei Astrology MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ziwei Astrology MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Ziwei Astrology MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ziwei Astrology MCP Server 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Ziwei Astrology MCP Server 能提供哪些能力?

资料显示能力标签包括 API密钥、位置天气、搜索。具体工具清单以官方文档为准。

Ziwei Astrology MCP Server 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Ziwei Astrology MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。