1. Conduid
  2. Developer Tools
  3. Mingpan
MCP server · Developer Tools

Mingpan

by · github.com/ChesterRa/mingpan

中华术数 MCP 排盘服务：八字・紫微斗数・六爻・梅花易数・大六壬・奇门遁甲｜Deterministic Chinese-metaphysics chart calculator for AI agents (MCP). Facts only — interpretation is left to the AI.

Unclaimed Apache-2.0 devtools
InstallView source
63Good

Scored 3 days ago · breakdown

About Mingpan

Mingpan is an MCP server published by ChesterRa in the Developer Tools category: 中华术数 MCP 排盘服务：八字・紫微斗数・六爻・梅花易数・大六壬・奇门遁甲｜Deterministic Chinese-metaphysics chart calculator for AI agents (MCP). Facts only — interpretation is left to the AI.

The repository has 119 stars and 39 forks, with the last commit 23 days ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/ChesterRa/mingpan

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Mingpan

Powered by Claude · Grounded in docs

I know everything about Mingpan. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.1.8v0.1.8 · 29 Sep 2026本次修复梅花易数的变卦与互卦计算错误，并补强从爻位计算到实际 MCP 输出的回归验证。 梅花易数正确性修复 统一八卦数组与反向映射的爻序：从下到上排列，动爻 1 为初爻、6 为上爻。数字起卦和时间起卦均生效。 修复初／三爻、四／六爻动时变卦位置颠倒的问题，以及互卦取爻错误。例如：天泽履四爻动为风泽中孚，六爻动为兑为泽；山雷颐初爻动为山地剥，互卦为坤为地。 按项目现有取互规则，旧实现中 384 种变卦组合有 256 种错误，64 卦的互卦有 60…
v0.1.7v0.1.7 · 2 Sep 2026官方托管服务版：Mingpan 仍保持 `0.1.x` 阶段，本次不扩大命理解释范围，重点是让开源计算引擎拥有一个可直接使用、可持续发布的官方入口。 用户可见变化 开源项目网站：`https://mingpan.bzwai.com` Remote MCP：`https://mingpan.bzwai.com/mcp` 四种网站语言：繁体中文、简体中文、English、日本語 无需安装 Node.js 或自行部署；在支持 Remote MCP / Streamable…
v0.1.6v0.1.6 · 2 Sep 2026MCP SDK v2 迁移版：升级至 2026-07-28 无状态协议，原生支持 Cloudflare Workers，向后兼容旧客户端。 升级内容 MCP SDK v2（`@modelcontextprotocol/server` 2.0） 协议升级：从 2025-03-26（需要 initialize 握手）升级至 2026-07-28（完全无状态协议），每个请求自包含所需信息，无需会话管理 向后兼容：内置…
v0.1.5v0.1.5 · 1 Sep 2026口径裁决与历法原语版：五项核心术数口径依典籍收紧（子初换日、起运权威化、年盘典籍化等），新增历法原语层（节气秒级查询 + 公农历互转），远程 MCP 形态（Cloudflare Workers），测试 218→288。 ⚠️ 升级须知（与 0.1.4 的不兼容变更） 1. 子初换日（影响所有系统）：23:00–24:00…
v0.1.4v0.1.4 · 28 Aug 2026面向正确性与产品定位的重构版：修复了八字与奇门两类长期存在的排盘缺陷，确立「只输出确定性排盘量，解读交还 AI」的产品边界，新增多时区与大六壬时间起课。 ⚠️ 升级须知（与 0.1.3 的不兼容变更） 1. 八字 · 二月出生者结果可能变化：年柱此前在「立春至春节」窗口（每年 2 月上中旬约两周）按春节换年错排，连带月干、大运顺逆出错；现按立春精确时刻换年（分钟级边界经公开节气数据验证）。 2. 八字 ·…

README

命盘 MCP Server

简体中文（主文档） | English | 日本語

Version License

命盘（Mingpan） 是一个开源的中华传统术数 MCP 计算引擎，为 AI 应用提供命理排盘与占卜起卦能力。BaziWei 同时维护可直接使用的官方远程服务。

立即使用官方 MCP

将下面的端点添加到支持 Remote MCP / Streamable HTTP 的 AI 客户端：

https://mingpan.bzwai.com/mcp

无需安装 Node.js，也无需自行部署服务器。添加后可以直接尝试：

请帮我排一个八字命盘，1992年4月12日7点30分，男性

请帮我起一个奇门遁甲时盘，2024年6月21日10点

先访问 Mingpan 开源项目网站 可查看能力范围与连接说明。官方服务由 BaziWei 维护；源代码与计算口径继续在本仓库公开，方便审阅、复现与共同改进。

特性

  • MCP 原生：无缝集成 Claude Desktop 及 Claude Code
  • 🌏 中文输出：以简体为主，术语保持传统
  • 📊 结构化文本：便于 AI 理解与分析的格式
  • 🕐 多时区支持：海外出生/起卦时间自动换算为北京时间排盘

使用方式

形态 适用 用法
官方远程 MCP（推荐） 支持 Remote MCP / Streamable HTTP 的 AI 客户端 添加 https://mingpan.bzwai.com/mcp
本地 stdio MCP 本地开发、离线使用或要求资料不离开设备 见下方可选配置

官方远程服务使用无状态纯计算：不建立命盘数据库，不缓存或记录出生参数与命盘结果。若要求资料完全不离开设备，可选择本地 stdio 形态。

本地运行（可选）

Claude Desktop

找到配置文件并添加以下内容：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mingpan": {
      "command": "npx",
      "args": ["-y", "mingpan"]
    }
  }
}

Claude Code

claude mcp add mingpan -- npx -y mingpan

验证

配置完成后重启客户端，然后尝试：

请帮我排一个八字命盘，1992年4月12日7点30分，男性

请帮我起一个奇门遁甲时盘，2024年6月21日10点

工具列表

命理排盘

命理学基于出生时间推算人生运势，属于「命」的范畴。

八字命理

工具 说明
bazi_basic 八字四柱排盘（干支纳音、天干/藏干十神、十二长生自坐、命宫/胎元、旬空、公农历对照；五行/格局/用神由 AI 分析）
bazi_dayun 大运列表（十年一运）
bazi_liunian 流年列表（指定年份范围）
bazi_liuyue 流月列表（节气月，立春起算）
bazi_liuri 流日列表（指定月份内每日）

紫微斗数

工具 说明
ziwei_basic 紫微命盘排盘（十二宫、主星、辅星、五行局/命主/身主、四化）
ziwei_daxian 大限列表（十年一限）
ziwei_xiaoxian 小限列表（每年一宫）
ziwei_liunian 流年列表（指定年份范围）
ziwei_liuyue 流月列表（农历月）
ziwei_liuri 流日列表（农历日）

历法原语

历法计算是所有术数的公共地基，也可独立使用。

工具 说明
jieqi_query 二十四节气精确时刻查询（精确到秒，北京时间）
calendar_convert 公历/农历互转（含闰月、干支年月日、生肖）

节气是天文事件（AI 无法推算，如 2025 年立春是 2 月 3 日 22:10 而非 2 月 4 日）， 农历闰月分配无简单规律（AI 经常猜错）——两者是本产品确定性计算的核心价值。

占卜起卦

占卜术基于起卦时间或随机数推演卦象，属于「卜」的范畴。

六爻

工具 说明
liuyao_basic 六爻排盘（本卦/变卦、纳甲、六亲、六神、世应、旬空、伏神/飞神、进退神、旺衰）

六爻输入为六个爻值（自下而上）：

  • 6 = 老阴（动爻，阴变阳）
  • 7 = 少阳（静爻）
  • 8 = 少阴（静爻）
  • 9 = 老阳（动爻，阳变阴）

梅花易数

工具 说明
meihua_basic 梅花易数排盘（本卦/变卦/互卦、体用分析）

支持两种起卦方式：

  • 时间起卦：根据农历年月日时计算
  • 数字起卦：根据两个数字计算

爻位统一自下而上编号 1–6；变卦反转指定动爻，互卦取本卦第 2、3、4 爻为下卦，第 3、4、5 爻为上卦。依据为《梅花易数》卷一的八卦象例、爻以六除与互卦起例。当前实现对乾、坤也按相同爻位取互；未采用原文另述的“乾坤无互，互其变卦”分支。

0.1.8 修复：Issue #2 指出的爻序映射错误会影响旧版的变卦和互卦。按上述取互规则，64 卦 × 6 动爻中有 256 个变卦结果、64 卦中有 60 个互卦结果需要纠正。时间与数字起卦均受影响；本卦、动爻编号与本卦体用关系不变，输入参数和文本结构兼容。升级后，依赖旧互变卦的解读需重新计算后复核。

大六壬

工具 说明
daliuren_basic 大六壬排盘（天地盘、四课、三传、十二天将、神煞）

大六壬为三式之首。推荐直接输入公历起课时间（year/month/day/hour）， 节气、月将、日干支、时干支由系统自动推得（LLM 手推干支极易出错）。 也可显式指定 jieqi/dayGanZhi/hourGanZhi（专家模式，向后兼容）。

奇门遁甲

工具 说明
qimen_basic 奇门遁甲排盘（九宫布局、三奇六仪、八门九星八神、格局检测）
qimen_yongshen 奇门用神分析（按事类选取用神，含主客、旺衰、空亡、入墓等确定性信息）

奇门遁甲为三式之一，盘式与规则主要参考张志春《神奇之门》，支持：时盘/日盘/月盘/年盘、转盘/飞盘、拆补法/茅山法。

输出示例（bazi_basic）

=== 命主資料 ===
性別：男
公曆：1992-04-12 07:30:00
農曆：壬申年三月初十辰時

=== 八字命盤 ===
年柱：壬申（剑锋金）  月柱：甲辰（覆灯火）  日柱：戊午（天上火）  時柱：丙辰（沙中土）
日柱旬空：子丑
命宮：己酉　胎元：乙未
天干十神：年干水=偏財　月干木=七殺　時干火=偏印
藏干十神（※本氣）：年申[庚食神※ 壬偏財 戊比肩]　月辰[戊比肩※ 乙正官 癸正財]　日午[丁正印※ 己劫財]　時辰[戊比肩※ 乙正官 癸正財]
十二長生（自坐）：年长生　月衰　日帝旺　時冠带

只包含确定性排盘信息；五行强弱、格局、用神等解读由 AI 依据盘面自行分析。

输入参数

命理工具（八字/紫微）

参数 类型 必填 说明
year number ✓ 出生年份（1900-2100）
month number ✓ 出生月份（1-12）
day number ✓ 出生日期（1-31）
hour number ✓ 出生时辰（0-23）
minute number 出生分钟（0-59），默认 0
gender string ✓ male / female
longitude number 出生地经度，用于真太阳时校正
isLunar boolean 是否为农历输入，默认 false
timezone string IANA 时区名（如 America/New_York），默认北京时间

时区说明（v0.1.4+）

  • 输入时间默认按北京时间排盘
  • 海外出生/起卦时提供 timezone 参数，系统将当地墙钟时间换算为北京时间后计算
  • 输入侧使用 IANA 时区数据库（正确处理各国历史夏令时，如 1986-1991 年中国夏令时）
  • 内部规范表示为 UTC+8 平太阳时，与历法换算口径一致

占卜工具（六爻/梅花/大六壬）

  • 六爻/梅花：输入起卦时间（支持 timezone），爻值/卦数由调用方提供
  • 大六壬：推荐直接输入公历时间，节气与干支自动推得；也可显式指定（专家模式）

奇门遁甲工具

参数 类型 必填 说明
year number ✓ 起盘年份（1900-2100）
month number ✓ 起盘月份（1-12）
day number ✓ 起盘日期（1-31）
hour number ✓ 起盘时辰（0-23）
minute number 分钟（0-59），默认 0
isLunar boolean 是否为农历输入，默认 false
timezone string IANA 时区名，默认北京时间
panType string 时盘 / 日盘 / 月盘 / 年盘，默认 时盘
panStyle string 转盘 / 飞盘，默认 转盘
zhiRunMethod string chaibu（拆补法）/ maoshan（茅山法），默认 chaibu

月份基准说明

系统 月份基准 日期基准
八字 节气月（立春起算） 公历日
紫微 农历月（初一起算） 农历日

开发

git clone https://github.com/ChesterRa/mingpan.git
cd mingpan
npm ci
npm run check                 # 构建 + 完整测试
npm run deploy:worker:dry-run # 只验证 Worker 打包，不部署
npm run dev  # 监听变化

依赖

库 用途
@modelcontextprotocol/server MCP v2 服务端协议实现
@modelcontextprotocol/client MCP v2 协议集成测试
lunar-javascript 农历/公历转换
iztro 紫微斗数计算引擎
zod 输入参数校验

路线图

  • 八字基础排盘与时运列表
  • 紫微基础排盘与时运列表
  • 六爻排盘
  • 梅花易数排盘
  • 大六壬排盘
  • 奇门遁甲排盘
  • 大六壬时间起课（自动推节气/干支）
  • 多时区支持（timezone 参数）
  • 奇门口径修正（拆补符头、地盘布局、转盘星门，参照《神奇之门》与 kinqimen 交叉验证）
  • 排盘完整性对称盘点（八字补纳音/藏干十神/十二长生/命宫胎元，紫微补五行局/命主/身主）
  • 输出契约测试全覆盖 + 权威用例金样本（历史人物记载、立春分钟级边界、iztro 适配保真）

版本历史

版本 说明
0.1.8 梅花正确性修复：统一八卦爻序与反向映射，纠正变卦和互卦；独立位运算穷举 384 种变卦与 64 种互卦，补齐 MCP、HTTP 与构建后 stdio 回归；感谢 @1270643866 的详细报告
0.1.7 官方托管服务：mingpan.bzwai.com 产品站与 /mcp 同仓、同版本、同一 Worker 发布；生产域名、无状态隐私边界、Host/Origin、请求体、限流与现代 MCP 协议烟雾测试完成收口；测试 300
0.1.6 MCP SDK v2 迁移（2026-07-28 无状态协议，原生支持 Cloudflare Workers，向后兼容旧客户端）；远程 HTTP 入口从 50 行简化为 20 行（createMcpHandler）；Workers 打包 gzip 638→606KB；测试 288
0.1.5 口径裁决：子初换日（23:00 起日柱时柱同属次日，全五系统统一）；起运权威化（lunar 节气表 + 交运日历定位）；奇门年盘按《遁甲演义》典籍修正；真太阳时四柱全量生效；新能力：历法原语层（jieqi_query + calendar_convert）；测试 218→288
0.1.4 正确性修复：八字立春换年、奇门四类口径修正、stdio 日志修复；输出定位确立：只输出确定性排盘量；大六壬时间起课、多时区；测试 117→218
0.1.3 奇门用神分析与择日
0.1.2 六爻、梅花易数、大六壬
0.1.0 首个发布：八字、紫微

许可证

Apache License 2.0

README fetched from the repository 5 days ago. The original is authoritative.

Questions

About Mingpan

How do I install Mingpan?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Mingpan safe to use with an AI agent?

Its trust score is 63 out of 100 (good). It passes 5 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Mingpan still maintained?

Yes — the latest release is v0.1.8 (29 Sep 2026), and the last commit was 23 days ago. The repository has 119 stars and 1 open issues.