How do I use Bazi (Eight Characters) Calculation MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Bazi (Eight Characters) Calculation MCP Server calculate the Bazi and Five Elements for May 20, 1990 at 10:00 AM" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

八字计算MCP服务器

🔮 专业的八字计算MCP服务器

npm version License: MIT

✨ 特性

🚀 一行命令启动: npx @mymcp-fun/bazi
📊 完整八字分析: 四柱、五行、生肖、星座、农历日期
🌍 时区支持: 支持全球时区的准确计算
🔗 MCP协议兼容: 无缝集成Claude Desktop等MCP客户端
⚡ TypeScript构建: 类型安全，性能优异
🧪 完整测试: 100%测试覆盖率

🚀 快速开始

直接使用 (推荐)

npx @mymcp-fun/bazi

全局安装

npm install -g @mymcp-fun/bazi bazi # 安装后可直接使用 bazi 命令

🔧 MCP客户端配置

Claude Desktop

在 claude_desktop_config.json 中添加：

{ "mcpServers": { "bazi": { "command": "npx", "args": ["-y", "@mymcp-fun/bazi"] } } }

其他MCP客户端

本服务器兼容所有标准MCP客户端，包括：

Claude Desktop
Zed Editor
VS Code (通过MCP扩展)
自定义MCP客户端

📊 工具API

get_bazi_details

计算生辰八字和五行信息

输入参数:

year (number): 出生年份 (1900-2100)
month (number): 出生月份 (1-12)
day (number): 出生日期 (1-31)
hour (number): 出生时间 (0-23)
gender (string, 可选): 性别 "male" 或 "female"，默认 "male"
timezone (string, 可选): 时区，默认 "Asia/Shanghai"

返回结果:

{ "四柱": { "年柱": "乙酉", "月柱": "己丑", "日柱": "丁巳", "时柱": "壬子" }, "五行": { "木": 1, "火": 2, "土": 2, "金": 1, "水": 2 }, "生肖": "鸡", "星座": "水瓶", "农历": { "农历年": 2005, "农历月": 12, "农历日": 29, "是否闰月": false, "农历月名": "腊月" }, "日主": "丁" }

🧪 开发和测试

克隆项目

git clone https://github.com/mymcp-fun/bazi.git cd bazi

安装依赖

npm install

开发模式

npm run dev

构建项目

npm run build

运行测试

# 运行所有测试 npm test # 单独运行测试 npm run test:basic # 基础功能测试 npm run test:mcp # MCP服务器测试 npm run test:lunar # lunar-javascript API测试 npm run test:accuracy # 准确性测试

📁 项目结构

bazi/ ├── src/ │ ├── server.ts # MCP服务器主入口 │ ├── bazi-service.ts # 八字计算服务 │ └── types.ts # TypeScript类型定义 ├── tests/ # 测试文件 ├── dist/ # 编译输出 └── package.json # npm配置

🔧 技术栈

MCP SDK: @modelcontextprotocol/sdk (最新版本)
八字计算: lunar-javascript (权威库，1600+周下载量)
开发语言: TypeScript 5.0+
运行环境: Node.js 18+
依赖管理: npm

📦 作为库使用

本包除了可以作为 MCP 服务器使用，还可以作为 npm 库直接在项目中使用：

npm install @mymcp-fun/bazi

可用的导出模块

@mymcp-fun/bazi/service - 八字计算服务类
@mymcp-fun/bazi/types - TypeScript 类型定义
@mymcp-fun/bazi - 完整的 MCP 服务器

📝 使用示例

在Claude Desktop中使用

配置MCP服务器后重启Claude Desktop
看到工具图标表示服务器已连接
提问示例：

请帮我计算一下2006年1月28日23时50分出生的人的八字信息

Claude会自动调用八字计算工具并返回详细分析：

八字四柱：乙酉己丑丁巳壬子生肖：鸡星座：水瓶座农历：2005年腊月廿九五行分布：木1 火2 土2 金1 水2 日主：丁

编程调用示例

// 导入八字计算服务 import { MCPBaziService } from '@mymcp-fun/bazi/service'; import { BaziResult } from '@mymcp-fun/bazi/types'; const service = new MCPBaziService(); const result: BaziResult = await service.calculateBazi({ year: 2006, month: 1, day: 28, hour: 23 }); console.log(`四柱: ${result.四柱.年柱} ${result.四柱.月柱} ${result.四柱.日柱} ${result.四柱.时柱}`); console.log(`生肖: ${result.生肖}`); console.log(`星座: ${result.星座}`);

🎯 准确性保证

技术基础

使用lunar-javascript作为计算引擎，这是最受信任的中文农历计算库之一
周下载量1600+，远超其他同类包
由专业开发者6tail维护，专门为中文传统算法设计

测试验证

✅ 传统命理学经典案例测试通过
✅ 边界时间处理测试通过
✅ 全时区计算验证通过
✅ 100%测试覆盖率

计算特色

支持完整的天干地支计算
准确的五行分析和权重计算
正确的生肖和星座判断
精确的农历日期转换

🌟 为什么选择这个包？

传播简单: 一行npm命令，无需复杂环境配置
计算准确: 基于权威lunar-javascript库，保证结果可靠
功能完整: 不仅有四柱，还包含生肖、星座、农历、五行分析
开发友好: TypeScript类型安全，现代化开发体验
生态兼容: 完美支持MCP协议，可与各种AI客户端集成

📞 支持

🐛 问题反馈: GitHub Issues
📧 联系作者: howard@mymcp.fun
🌐 项目主页: mymcp.fun

📄 许可证

MIT License - 查看 LICENSE 文件了解详情。

🌟 如果这个项目对你有帮助，请给个Star支持一下！

Bazi (Eight Characters) Calculation MCP Server