MCP 服务器

Bazi (Eight Characters) Calculation MCP Server

Provides professional Chinese astrology calculations including Four Pillars, Five Elements, zodiac signs, and lunar calendar details. It allows users to perform accurate Bazi analysis with global timezone support directly within MCP-compatible clients.

README

八字计算MCP服务器

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

✨ 特性

🚀 一行命令启动: 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.星座}`);