Yijing Bazi MCP Server

易经八字分析 MCP 服务器

基于 MCP（Model Context Protocol）的易经与八字分析服务，提供起卦/解读、八字排盘/分析与综合咨询等能力。

快速开始

本地运行

npm install
npm start

开发模式

npm run dev

NPM/NPX 运行

npx yijing-bazi-mcp@latest

客户端配置

Claude Desktop

{
  "mcpServers": {
    "yijing-bazi": {
      "command": "npx",
      "args": ["yijing-bazi-mcp@latest"],
      "env": {
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}

如果使用本地项目：

{
  "mcpServers": {
    "yijing-bazi": {
      "command": "node",
      "args": ["src/index.js"],
      "cwd": "项目完整路径",
      "env": {
        "LOG_LEVEL": "info",
        "NODE_ENV": "development"
      }
    }
  }
}

配置文件位置：

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

其他 MCP 客户端（Trae/Cursor/Cherry Studio）

推荐用 npm exec：

{
  "mcpServers": {
    "yijing-bazi": {
      "command": "npm",
      "args": ["exec", "yijing-bazi-mcp"],
      "cwd": "项目完整路径",
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

可用工具（概览）

• 易经：yijing_generate_hexagram, yijing_interpret, yijing_advise
• 八字：bazi_generate_chart, bazi_analyze, bazi_forecast
• 综合：combined_analysis, destiny_consult
• 学习：knowledge_learn, case_study

使用示例

易经起卦

{
  "tool": "yijing_generate_hexagram",
  "params": {
    "question": "今年是否适合创业？",
    "method": "coin",
    "context": "目前在大公司工作，考虑自主创业"
  }
}

八字分析

{
  "tool": "bazi_generate_chart",
  "params": {
    "birth_time": "1990-05-15T10:30:00+08:00",
    "gender": "male",
    "is_lunar": false,
    "timezone": "Asia/Shanghai"
  }
}

环境变量

支持 .env：

LOG_LEVEL=info
NODE_ENV=production
SERVER_NAME=yijing-bazi-mcp-server
ENABLE_CACHE=true

目录结构（简版）

src/
  engines/   # 易经/八字/综合/知识引擎
  data/      # 静态数据与表
  utils/     # 工具/日志/校验/缓存
  config/    # 运行时配置
  index.js   # 入口

免责声明

本项目仅供学习研究使用，分析结果仅供参考，不构成任何决策建议。