技术文档摘要

紫微斗数 MCP 服务器

基于模型上下文协议（MCP）的专业紫微斗数命理分析服务器，提供生成、解读、分析和可视化算命图的完整功能。支持传统的紫微斗数算法，并结合现代的数据持久性和可视化技术。

🌟 功能特性

核心功能

• 🔮 命运图生成：根据农历算法生成完整的紫微斗数命运图
• 📖 命运图解读：提供详细的图表分析和专业解释
• 🌟 运势分析：分析当前和未来的运势趋势
• 💕 婚姻分析：双命盘婚配分析
• 📅 择日功能：根据图表选择吉日良时
• 🤖 AI智能解锁：结合传统算命与现代AI技术

可视化功能

• 🎨 命运图图像：生成多种风格的算命图表
• 📊 数据可视化：支持SVG、PNG和HTML等多种格式输出
• 🎭 主题定制：多种颜色方案，包括传统、现代、彩色、黑白等

专业分析

• ⭐ 星象信息：查询各种星象的详细信息及其影响
• 🏠 宫位分析：十二宫位的意义及深入分析
• 📈 人生时间轴：详细分析大运年表
• 👥 人际关系：家庭、朋友及职业关系分析
• 💼 职业指导：职业发展及决策支持
• 🏥 健康分析：健康趋势及建议
• 🎓 教育指导：学习能力和教育规划

📦 安装

环境要求

• Node.js 18.0+
• npm 8.0+
• SQLite 3.0+

安装依赖

npm install

🚀 使用说明

启动服务

# 开发模式
npm run dev

# 生产模式
npm start

客户端配置（STDio）

如果你使用支持MCP的客户端（如Claude Desktop），可以通过STDio连接到此服务：

Claude Desktop 配置

在Claude Desktop的配置文件中添加以下配置：

{
  "mcpServers": {
    "ziwei-doushu": {
      "command": "npx",
      "args": ["-y","ziwei-mcp"]
    }
  }
}

📚 API 文档

核心工具

1. generate_chart - 生成命运图

生成完整的紫微斗数命运图

参数：

• name (string): 姓名
• birthDate (string): 出生日期 (YYYY-MM-DD)
• birthTime (string): 出生时间 (HH:MM)
• gender (string): 性别 (male/female)
• location (object): 出生地
  • province (string): 省份
  • city (string): 城市
  • longitude (number): 经度
  • latitude (number): 纬度
• timezone (string): 时区 (默认: Asia/Shanghai)
• calendar (string): 日历类型 (solar/lunar, 默认: solar)

2. interpret_chart - 命运图解读

提供详细的图表分析和解释

参数：

• chartId (string): 命盘ID
• aspects (array): 解读方面
  • 性格: 性格特质
  • 职业: 职业发展
  • 财富: 财富运势
  • 关系: 情感关系
  • 健康: 健康状况
  • 家庭: 家庭关系
• detailLevel (string): 详细程度 (basic/detailed/comprehensive)

3. analyze_fortune - 运势分析

分析特定时期的运势趋势

参数：

• chartId (string): 命盘ID
• period (string): 分析周期 (current_year/next_year/decade/custom)
• startDate (string): 开始日期 (YYYY-MM-DD)
• endDate (string): 结束日期 (YYYY-MM-DD)
• aspects (array): 分析方面

4. analyze_compatibility - 婚姻分析

双命盘婚配分析

参数：

• chart1Id (string): 第一人的命运图ID
• chart2Id (string): 第二人的命运图ID
• analysisType (string): 分析类型 (marriage/business/friendship)
• aspects (array): 分析维度

5. select_auspicious_date - 择日功能

根据图表选择吉日良时

参数：

• chartId (string): 命盘ID
• eventType (string): 事件类型
• dateRange (object): 日期范围
• preferences (object): 偏好设置

可视化工具

6. generate_visualization - 生成可视化图表

生成算命的可视化图表，支持多种风格和格式

参数：

• chartId (string): 命盘ID
• visualizationType (string): 可视化类型
  • Traditional-chart: 传统图表
  • Modernist wheel: 现代轮盘
  • Palace_grid: 宫格
  • Star_map: 星空图
• includeElements (array): 包含元素
• colorScheme (string): 颜色方案
• outputFormat (string): 输出格式 (svg/png/html)

专业分析工具

7. analyze_life_timeline - 人生时间轴分析

分析人生的时间轴，包括重大事件和年份的详细分析

8. analyze_relationships - 人际关系分析

分析人际关系，包括家庭、朋友、同事等

9. career_guidance - 职业发展指导

职业发展指导和决策支持

10. health_analysis - 健康分析

健康分析和保健建议

11. educational_guidance - 教育指导

教育和学习指导

🛠️ 开发指南

开发环境设置

# 进入项目目录
cd 紫微斗数

# 安装依赖
npm install

# 启动MCP服务器
npm start

# 或启动开发模式
npm run dev

可用脚本

npm start      # 启动MCP服务器
npm run dev    # 启动开发模式（带调试）
npm test       # 运行基础测试
npm run lint   # ESLint代码检查
npm run format # Prettier代码格式化

代码标准

• 使用ESLint进行代码检查
• 使用Prettier格式化代码
• 遵循CommonJS模块规范
• 支持Node.js版本18.0+

🔧 配置说明

配置文件

项目使用的配置文件如下：

• config/sqlite-config.js - SQLite数据库配置
• config/persistence-config.js - 数据持久性配置
• package.json - 项目依赖和脚本配置

数据库配置

项目使用SQLite作为数据存储，配置文件位于config/sqlite-config.js。

📖 使用示例

生成命运图示例

// 通过MCP调用
const chart = await mcpClient.callTool('generate_chart', {
  name: '张三',
  birthDate: '1990-01-01',
  birthTime: '08:30',
  gender: 'male',
  location: {
    province: '北京市',
    city: '北京市',
    longitude: 116.4074,
    latitude: 39.9042
  }
});

解读命运图示例

const interpretation = await mcpClient.callTool('interpret_chart', {
  chartId: chart.id,
  aspects: ['personality', 'career', 'wealth'],
  detailLevel: 'detailed'
});

🤝 贡献指南

1. Fork项目
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开Pull Request

提交规范

feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试相关
chore: 构建过程或辅助工具的变动

📄 许可证

该项目采用MIT许可证。

🆘 支持与反馈

• 📚 详细文档：紫微斗数 MCP 开发文档
• 📋 SQLite部署：SQLite部署指南
• 🎨 SVG生成：SVG生成器用户指南

🔗 相关链接

• 模型上下文协议
• Claude Desktop
• lunar-javascript 库 - 农历转换核心库

---

注意 本项目仅供学习和研究之用，算命分析结果仅供参考，不应作为重大生活决策的唯一依据。

📋 更新日志

v1.0.0 (2024-01-01)

• ✨ 初始版本发布
• 🔮 实现基本的命运图生成功能
• 📖 支持命运图解读和运势分析
• 🎨 添加SVG图像生成
• 💾 集成SQLite数据持久性
• 🤖 支持AI智能解锁
• 💕 添加婚姻分析功能
• 📅 实现择日功能

❓ 常见问题

Q: 为什么生成的图表与其他软件不同？ A: 不同的紫微斗数软件可能使用不同的算法和参数。本服务是基于传统算法实现的，结果可能会有所不同。

Q: 哪些地区支持哪些时区？ A: 支持全球主要时区，以Asia/Shanghai（北京时间）为默认。

Q: 数据会保存多久？ A: 目前数据将永久保存在本地SQLite数据库中，你可以手动清理任何不必要的数据。

Q: 如何获得更准确的分析结果？ A: 请确保输入准确的出生日期、时间和地点信息，时间精确到分钟级别。

🔧 技术支持

如果遇到技术问题，请提供以下信息：

1. 错误消息和错误代码
2. 输入参数信息
3. 操作系统和Node.js版本
4. 详细操作步骤

解释数据