Skip to main content
Glama
ChesterRa

命盘 Mingpan

by ChesterRa

命盘 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 维护;源代码与计算口径继续在本仓库公开,方便审阅、复现与共同改进。

Related MCP server: taibu

特性

  • 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

梅花易数排盘(本卦/变卦/互卦、体用分析)

支持两种起卦方式:

  • 时间起卦:根据农历年月日时计算

  • 数字起卦:根据两个数字计算

大六壬

工具

说明

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.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

Available Tools

17 tools
bazi_basicA

计算八字命盘(基础排盘)。

输入出生时间,返回完整的八字命盘信息:

  • 四柱(年柱、月柱、日柱、时柱)干支

  • 各柱藏干

  • 十神配置

  • 五行力量分析(360分制)

  • 日主强弱判定

  • 格局识别

  • 神煞标注

输出为结构化文本,便于 AI 分析解读。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderNoGender for DaYun calculation directionmale
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
detailNoOutput detail levelstandard
includeAnalysisNoInclude strength and pattern analysis
includeDaYunNoInclude decade fortune (大運)
targetYearNoCalculate LiuNian (流年) for this specific year

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, but the description details inputs like longitude for true solar time and lunar calendar conversion, and lists comprehensive output. It does not mention safety traits but the tool is inherently read-only.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, with a clear opening sentence and bullet-pointed output list. Every sentence adds value without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of Bazi and no output schema, the description adequately covers input adjustments and output components. It could mention error handling or validation, but is sufficient for typical use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the description adds value by explaining the purpose of gender (for DaYun direction) and longitude (true solar time), which are not fully detailed in the schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states '计算八字命盘(基础排盘)' and lists all output components, distinguishing it from sibling tools like bazi_dayun and bazi_liunian which focus on specific aspects.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies this is the primary tool for basic Bazi calculation, but lacks explicit guidance on when to use alternatives or preconditions such as requiring accurate birth time.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bazi_dayunA

八字大运列表。

返回命主一生的大运周期(十年一运):

  • 大运干支

  • 起止虚岁

  • 对应公历年份

  • 起运方向(顺行/逆行)

  • 起运年龄

用于了解人生各阶段的运势大框架。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
countNoNumber of DaYun periods to display (default 10)

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description bears full responsibility for behavioral transparency. It describes the output but does not disclose any potential side effects, authentication needs, or rate limits. For a read-only calculation tool, this is adequate but not exceptional.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, front-loaded with the title, and uses bullet points for clarity. Every sentence adds value, and there is no wasted text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of the tool (10 parameters, no output schema), the description provides a useful overview of the output structure. It lacks details on data types or exact format, but is sufficient for an agent to call the tool and understand the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, so each parameter is already explained. The description adds marginal value by listing output fields, but does not enhance parameter understanding beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: to list the Da Yun (great fortune) cycles of a person's life. It specifies the output fields (stem-branch, starting age, years, direction, start age), making it distinct from other Bazi tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description includes a usage context: '用于了解人生各阶段的运势大框架' (used to understand the general framework of life stages). However, it does not specify when not to use this tool or mention alternatives among siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bazi_liunianA

八字流年列表。

返回指定年份范围内的流年信息:

  • 公历年份

  • 干支年

  • 虚岁

  • 所属大运

用于分析多年运势趋势。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
startYearYesStart year for the range
endYearYesEnd year for the range

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description fully discloses what the tool does: it returns a list of annual data with specified fields for a given year range. There are no side effects or destructive actions implied, and the output structure is clearly outlined. This meets the burden for transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise, using a short paragraph with a bullet list for output fields. Every sentence adds value, and the key information is front-loaded. No unnecessary verbosity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given there is no output schema, the description adequately explains what is returned (year, gan-zhi, age, dayun). It covers the core functionality for analyzing yearly trends. However, it omits details about how optional parameters like longitude or isLunar affect the output, which could be added for completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description does not add new meaning beyond the schema; it only summarizes the input (e.g., 'startYear/endYear' are mentioned). No extra detail on how parameters affect computation is provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns '流年信息' (annual fortune info) for a year range, listing specific fields (公历年份, 干支年, 虚岁, 所属大运). This distinguishes it from siblings like bazi_dayun (period luck) and bazi_liuri (daily luck) by focusing on yearly analysis over a range.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says '用于分析多年运势趋势' (used for analyzing multi-year trends), indicating when to use it. However, it does not mention when not to use it or compare with alternatives like bazi_dayun, leaving some ambiguity for an AI agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bazi_liuriA

八字流日列表。

返回指定月份内的每日运势(含上下文):

  • 当前大运、流年、流月资讯

  • 公历日期

  • 干支日

用于精细的日期选择。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
ganzhiYearYesThe year of the month
ganzhiMonthYesThe month to query (either GanZhi string or month number 1-12)

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It describes the output (list of daily fortunes with context) but does not mention whether it modifies state, requires prior setup, or performance characteristics. It is adequate for a read-only retrieval tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A concise paragraph with key points in bullet form. Front-loaded with the tool's purpose. No unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 11 parameters and no output schema, the description provides a useful summary of output fields (bullets) and a usage hint. It lacks explanation of how to interpret the context fields, but is otherwise complete enough for an AI to invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters well. The description adds no additional parameter meaning beyond listing output fields, which is baseline acceptable.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it returns daily fortune (运势) for a month with context (大运、流年、流月、日期、干支), using a specific verb '返回' (returns). It distinguishes from siblings like bazi_liunian (yearly) and bazi_liuyue (monthly) by specifying it's daily (流日).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says it's '用于精细的日期选择' (for fine date selection), indicating when to use. It does not explicitly state when to avoid or name alternatives, but the context of siblings makes the usage clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bazi_liuyueA

八字流月列表。

重要:八字流月使用【节气月】,非农历月!

  • 以节气为边界(立春起算)

  • 寅月(正月)从立春开始,约2月4日

  • 丑月(腊月)跨越公历年界

返回指定年份的12个月运势:

  • 干支月

  • 节气起止

  • 公历日期范围

用于规划年度活动时机。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
ganzhiYearYesThe year to query (either GanZhi string or Gregorian year)

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses key behavioral traits: it returns 12 monthly fortunes, uses solar terms (not lunar), and describes output fields (stem-branch month, solar term start/end, Gregorian date range). This adequately informs the agent about the tool's behavior, though it omits details like error handling or rate limits, which are less critical for a read-only tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured: a brief header, a bulleted list of key points, and a summary of output. Every sentence is informative with no fluff. It front-loads the critical distinction (solar vs lunar month) and provides essential context efficiently.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description explains the core concept of solar terms and output format, but it does not clarify how input parameters (birth date, gender, etc.) relate to the query year (ganzhiYear). An agent might not understand why birth data is needed for a monthly fortune tool. The output schema is absent, but the description partially compensates. Some context about the computation is missing, making it adequate but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description does not add significant parameter-specific meaning beyond the schema. It mentions '指定年份' but does not elaborate on the 'ganzhiYear' parameter's dual type (string or integer) or other inputs. The output format description is useful but not parameter semantics. No extra value added.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it returns a list of 12 monthly fortunes for a given year, using solar terms (节气月) instead of lunar months. It distinguishes from sibling tools like bazi_liunian (yearly) and bazi_liuri (daily) by specifying the monthly scope and output details like stem-branch months and solar term boundaries.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly warns that the tool uses solar terms, not lunar months, and provides concrete examples of boundaries (e.g., 立春, 寅月). This clarifies when to use it. However, it does not explicitly state alternatives or when not to use it, such as comparing with bazi_liunian or bazi_liuri, leaving room for improvement.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

daliuren_basicA

大六壬排盤(基礎排盤)。

大六壬是中國古老三大占卜術之一,與奇門遁甲、太乙神數並稱三式。

輸入節氣、農曆月、日干支、時干支,返回完整的六壬盤面:

  • 天地盤(月將加時辰起盤)

  • 四課(日干支推演)

  • 三傳(九宗門推演:賊尅、比用、涉害、遙尅、昴星、別責、八專、伏吟、返吟)

  • 十二天將(貴人、螣蛇、朱雀、六合、勾陳、青龍、天空、白虎、太常、玄武、太陰、天后)

  • 格局判斷

  • 神煞(日馬、月馬、丁馬、華蓋、閃電)

注意:

  • 需要提供節氣(如:立春、雨水、驚蟄等)

  • 日干支和時干支需要是完整的干支(如:甲子、乙丑)

  • 本工具只負責排盤,斷課解讀交給 Agent

輸出為 Markdown 格式,便於 AI 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
jieqiYes節氣(如:立春、雨水、驚蟄等)
lunarMonthYes農曆月份(1-12)
dayGanZhiYes日干支(如:甲子、乙丑等)
hourGanZhiYes時干支(如:甲子、乙丑等)
guirenMethodNo貴人起法:0=標準, 1=另一種

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

无注释,描述承担全部负担,清楚说明工具只排盘不解读,输出Markdown格式,但未提及可能的错误处理或性能特征,整体足够。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

描述较长但信息丰富,结构清晰(介绍->输出列表->注意事项),每句话有贡献,但可稍作精简以提升可读性。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

对于复杂的大六壬排盘工具,描述覆盖了所需输入、详细输出格式(Markdown)、注意事项,无输出模式但描述弥补,满足使用需求。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

输入模式覆盖100%参数,描述重复主要参数但未增加超出模式的语义细节(如guirenMethod仅说明“貴人起法”),与schema一致。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述明确说明工具执行大六壬基础排盘,列出详细输出内容(天地盘、四课、三传等),与兄弟姐妹工具(八字、六爻等)明显区分,动词“排盤”具体明确。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述了输入需求(节气、完整干支)和工具局限(仅排盘不解读),提供了使用上下文,但未明确排除其他工具或说明何时选择大六壬而非其他占卜方法。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

liuyao_basicA

六爻排盤(基礎排盤)。

輸入六個爻值和起卦時間,返回完整的六爻盤面:

  • 本卦/變卦(含卦名、卦宮、五行)

  • 六爻納甲(每爻地支及五行)

  • 六親(父母/兄弟/子孫/妻財/官鬼)

  • 六神(青龍/朱雀/勾陳/螣蛇/白虎/玄武)

  • 世應位置

  • 動爻標註

  • 日干支、月建、旬空

爻值說明:

  • 6 = 老陰(動爻,陰變陽)

  • 7 = 少陽(靜爻,陽)

  • 8 = 少陰(靜爻,陰)

  • 9 = 老陽(動爻,陽變陰)

輸入順序:自下而上(初爻到上爻)

輸出為 Markdown 格式,便於 AI 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
yaoValuesYes六個爻值(自下而上,初爻到上爻)。6=老陰(動), 7=少陽(靜), 8=少陰(靜), 9=老陽(動)
yearYes起卦年份(公曆)
monthYes起卦月份(1-12)
dayYes起卦日期(1-31)
hourYes起卦時辰(0-23)
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully discloses the tool's behavior: it takes yao values and date/time, returns a Markdown chart with many elements. It explains the meaning of yao values (6=old yin moving, etc.) and input order (bottom to top). No contradictions or omissions regarding side effects, but it doesn't mention error handling or performance constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with bullet points listing output components and yao value explanations. It is concise enough, though the enum values are repeated from the schema. The front-loaded purpose sentence is clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given there is no output schema, the description thoroughly explains the return values (all chart components) and input semantics. It covers the yao values, order, and date parameters. This is comprehensive for a complex divination tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, providing baseline 3. The description adds value by explaining the yao value meanings (6/7/8/9) and the bottom-to-top order beyond the schema descriptions. It also notes the output format (Markdown), which aids understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '六爻排盤(基礎排盤)' (Six Yao Charting - Basic). It lists the specific components returned (本卦/變卦, 六親, 六神, etc.), distinguishing it from sibling tools like bazi, ziwei, etc., which are different Chinese divination systems.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains that the tool is used to generate a complete Six Yao chart from yao values and a starting time. However, it does not explicitly state when not to use it or provide direct alternatives. The sibling tools list implies differentiation, but no clear guidance on choosing between them.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

meihua_basicA

梅花易數排盤(基礎排盤)。

支持兩種起卦方式:

  1. 時間起卦(method='time'):根據農曆年月日時起卦

  2. 數字起卦(method='number'):根據兩個數字起卦

返回完整的梅花盤面:

  • 本卦/變卦/互卦

  • 上卦/下卦(含卦象、五行)

  • 動爻位置

  • 體用分析(體卦、用卦、五行生剋關係)

  • 起卦數據詳情

時間起卦算法(農曆):

  • 上卦 = (年干支序數 + 月 + 日) % 8

  • 下卦 = (年干支序數 + 月 + 日 + 時辰序數) % 8

  • 動爻 = (年干支序數 + 月 + 日 + 時辰序數) % 6

輸出為 Markdown 格式,便於 AI 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
methodYes起卦方式:time=時間起卦,number=數字起卦
yearNo起卦年份(公曆,time 模式必填)
monthNo起卦月份(1-12,time 模式必填)
dayNo起卦日期(1-31,time 模式必填)
hourNo起卦時辰(0-23,time 模式必填)
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
upperNumberNo上卦數(number 模式必填)
lowerNumberNo下卦數(number 模式必填)
yaoNumberNo動爻數(可選,默認用上下卦數之和)

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It discloses the algorithm for time-based gua, the return format (Markdown), and components. However, it does not mention safety, side effects, or error handling, but the tool is inherently read-only and non-destructive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with a clear introduction, method list, output details, and algorithm. It is efficient with no superfluous content, though a slightly more concise algorithm description could improve readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 9 parameters and no output schema, the description adequately covers input methods, required parameters, and output components. However, it omits mention of the isLunar parameter and the number method algorithm is vague; still, it is reasonably complete for the domain.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with all parameters described individually. The tool description adds context about the two methods and algorithm but does not significantly enhance per-parameter meaning beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies the tool as generating Meihua Yishu basic chart, specifying two methods (time and number) and listing output components. This differentiates it from other Chinese divination siblings (e.g., bazi, liuyao) as a distinct system.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains the two available methods and what the tool returns, but does not explicitly state when to use this tool versus alternatives. It assumes domain knowledge that Meihua Yishu is for certain scenarios, but lacks direct guidance on exclusion or comparison with sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

qimen_basicA

奇門遁甲排盤(基礎排盤)。

奇門遁甲是中國古代三式之一,與大六壬、太乙神數並稱,用於預測和決策。

輸入時間信息,返回完整的奇門盤面:

  • 陰陽遁和局數(根據節氣判定)

  • 九宮布局(地盤干、天盤干)

  • 八門飛布(休、生、傷、杜、景、死、驚、開)

  • 九星飛布(天蓬、天芮、天沖、天輔、天禽、天心、天柱、天任、天英)

  • 八神排布(值符、螣蛇、太陰、六合、白虎、玄武、九地、九天)

  • 旬首信息(符頭、值符星、值使門、空亡)

  • 日干/時干落宮

  • 格局判斷(吉格/凶格約20-30種)

支持選項:

  • 盤類型:時盤(默認)、日盤、月盤、年盤

  • 盤式:轉盤(默認,遵循《神奇之門》)或飛盤

  • 置閏法:拆補法(默認)或茅山法

盤類型說明:

  • 時盤:以時辰為主導,適用於即時預測

  • 日盤:以日干支為主導,適用於當日吉凶

  • 月盤:以月干支為主導,適用於月度運勢

  • 年盤:以年干支為主導,適用於年度規劃

盤式說明:

  • 轉盤:天盤、八門、九星按物理方向旋轉(《神奇之門》派)

  • 飛盤:天盤、八門、九星按洛書軌跡飛布(傳統飛宮法)

輸出為 Markdown 格式,含 ASCII 九宮格,便於 AI 分析解讀。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYes年份(公曆,1900-2100)
monthYes月份(1-12)
dayYes日期(1-31)
hourYes時辰(0-23,24小時制)
minuteNo分鐘(0-59)
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
panTypeNo盤類型:时盘(默認)、日盘、月盘、年盘时盘
panStyleNo盤式:转盘(默認,遵循《神奇之門》)或飞盘转盘
zhiRunMethodNo置閏方法:chaibu=拆補法(默認),maoshan=茅山法chaibu

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description fully carries the burden of behavioral disclosure. It explains the output format (Markdown with ASCII 9-grid), lists all components, and describes options. No contradictions, and no destructive behavior is implied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with sections and bullet points, making it easy to parse. It is fairly long but every part contributes necessary context for a complex tool. Could be slightly more concise, but front-loaded with purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of Qi Men Dun Jia, the description covers input parameters, output contents, optional settings, and even background context. No output schema exists, but the description compensates by enumerating output elements. It is complete for an agent to use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description adds value by explaining the purpose of each pan type, pan style, and zhiRunMethod in detail, beyond what the schema provides. This enriches the agent's understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: '奇門遁甲排盤(基礎排盤)' and provides a detailed list of outputs and supported options. It distinguishes itself from siblings implicitly by being the basic chart-casting tool, while siblings like 'qimen_yongshen' and 'qimen_zeri' are specialized.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear guidance on when to use different pan types (時盤, 日盤, etc.) and pan styles, but does not explicitly contrast with sibling tools or specify when not to use this tool. The context is sufficient for an agent to infer usage scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

qimen_yongshenA

奇門遁甲用神分析。

在基礎排盤基礎上,根據事類選取用神並分析:

支持 14 種事類: 求財、婚姻、疾病、出行、訴訟、考試、工作、失物、置業、求官、孕產、尋人、合作、其他

分析內容

  • 主用神/輔用神識別及落宮

  • 用神旺相休囚死狀態

  • 用神空亡、入墓、擊刑檢測

  • 與日干生克關係

  • 受格局影響評估

  • 主客分析(涉及雙方的事類)

  • 年命分析(可選)

  • 神煞信息(可選)

評分系統: 每個用神 0-100 分,綜合考量各因素

輸出為結構化 Markdown,便於 AI 斷卦分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYes年份(公曆,1900-2100)
monthYes月份(1-12)
dayYes日期(1-31)
hourYes時辰(0-23,24小時制)
minuteNo分鐘(0-59)
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
panTypeNo盤類型:时盘(默認)、日盘、月盘、年盘时盘
panStyleNo盤式:转盘(默認)或飞盘转盘
zhiRunMethodNo置閏方法chaibu
shiLeiYes事類(用於確定用神)
nianGanNo年干(用於年命分析,可選)
includeShenShaNo是否包含神煞分析

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It comprehensively lists the analysis components: identification of main/auxiliary yong shen, status (旺相休囚死), empty/grave/torture, relationship with day stem, pattern effects, host-guest analysis, optional year stem and gods information, and a scoring system. It also notes output as structured Markdown. No side effects are mentioned, but the tool is likely read-only.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with bullet points and clear sections. It is informative without being overly verbose. While somewhat lengthy, the complexity of the topic justifies the length.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of the tool and the absence of an output schema, the description adequately covers the analysis process, parameters, and output format. It mentions the prerequisite of a basic pan, but could explicitly reference the sibling tool qimen_basic. The scoring system is noted but not detailed, which is acceptable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description adds value by explaining the purpose of key parameters like shiLei (the 14 affair types are listed), nianGan (year stem for optional analysis), and includeShenSha. This context goes beyond the schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it is for '奇門遁甲用神分析' (Qi Men Dun Jia Yong Shen analysis), specifying it operates on top of a basic pan and supports 14 specific affair types. This distinguishes it from sibling tools like qimen_basic (which likely handles the basic pan) and qimen_zeri (day selection).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear context: it should be used after obtaining a basic pan ('在基礎排盤基礎上'). It also lists 14 affair types for which it is intended. However, it does not explicitly state when not to use it or provide direct comparisons to sibling tools, though the specialization is implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

qimen_zeriA

奇門遁甲擇日功能。

在指定日期範圍內篩選吉時:

輸入

  • 起止日期範圍

  • 事類(14 種)

  • 可選過濾條件

評分維度

  • 格局評分(吉格加分、凶格減分)

  • 用神評分(得位、空墓等)

  • 神煞評分(吉神凶煞)

過濾條件

  • 最小評分閾值

  • 排除歲破日

  • 排除月破日

  • 排除節氣交接日

輸出

  • 推薦時辰列表(含評分、評級)

  • 有利因素、注意事項

  • 可選方位信息(三吉門方位、用神方位)

性能目標

  • 7天:< 2秒

  • 30天:< 5秒

  • 365天:< 60秒

ParametersJSON Schema
NameRequiredDescriptionDefault
startYearYes起始年份
startMonthYes起始月份
startDayYes起始日期
endYearYes結束年份
endMonthYes結束月份
endDayYes結束日期
shiLeiYes事類
limitNo返回數量限制(默認10)
minScoreNo最小評分閾值(0-100,默認60)
includeDirectionNo是否輸出方位信息
excludeJieQiDayNo是否排除節氣交接日
excludeSuiPoNo是否排除歲破日
excludeYuePoNo是否排除月破日
panTypeNo盤類型时盘
panStyleNo盤式转盘
zhiRunMethodNo置閏方法chaibu

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden. It discloses performance targets and the general workflow (scoring, filtering), but does not explicitly state if the tool is read-only, side-effect free, or any authorization requirements. Behavioral traits are partially covered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections (Input, Scoring, Filters, Output, Performance). It is relatively concise given the complexity, though some details like scoring dimensions could be streamlined. No redundant statements.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 16 parameters and no output schema, the description covers input, scoring dimensions, filter conditions, output structure, and performance goals. It is comprehensive for a specialized tool, though return value details could be more formal.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description groups parameters and explains scoring dimensions and filters, adding some context. However, it does not provide new syntax or meaning beyond what the schema already offers.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function as '奇門遁甲擇日功能' (Qi Men Dun Jia date selection) and '在指定日期範圍內篩選吉時' (filter auspicious times within a date range). It distinguishes from sibling tools like qimen_basic and qimen_yongshen by focusing specifically on date selection for various event types.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide explicit guidance on when to use this tool versus alternatives. It lists inputs and outputs but lacks scenarios or exclusions. Context suggests it is for date selection, but no comparison to sibling tools is given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ziwei_basicA

计算紫微斗数命盘(基础排盘)。

输入出生时间,返回完整的紫微命盘信息:

  • 十二宫位排布及干支

  • 各宫主星及亮度(庙/旺/得/利/平/不/陷)

  • 各宫辅星配置

  • 命宫与身宫位置

  • 本命四化(化禄/权/科/忌)

输出为结构化文本,便于 AI 分析解读。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender (required for ZiWei calculation)
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
detailNoOutput detail levelstandard
targetYearNoCalculate yearly fortune for this specific year
includeDecadesNoInclude decade fortune (大限)
includeMutagenNoInclude four mutagens (四化)

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries full burden. It describes the output structure and input requirements, but lacks details on side effects, error handling, or limitations. For a calculation tool, this is moderately transparent but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with two paragraphs, front-loading the purpose. It uses clear language and lists output items. Minor improvement could be using bullet points, but it is still efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, but the description partially compensates by listing output components. However, it omits exact output format or field details, which is important for a complex tool. Given the 11 parameters, the description is adequate but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%; each parameter already has a clear description. The tool description adds context about output content and the necessity of gender, but does not significantly enhance understanding beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it calculates a Ziwei Doushu natal chart (基础排盘) and lists specific output components (12 palaces, stars, brightness, auxiliary stars, etc.). It is distinct from sibling tools like ziwei_daxian or ziwei_liunian, which focus on different time periods.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what the tool does but provides no explicit guidance on when to use it vs. alternatives. It implies it is for obtaining the basic natal chart, but does not mention when to use siblings for detailed fortune analysis.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ziwei_daxianA

紫微大限列表。

返回命主一生的大限周期(十年一限):

  • 起止虚岁

  • 对应公历年份

  • 大限宫位名称

  • 宫内主星配置

  • 大限四化

用于了解人生各阶段的运势大框架。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
countNoNumber of decade periods to display (default 10)

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full responsibility. It describes the output but does not disclose behavioral traits such as whether it is read-only, requires authentication, or has rate limits. The description does not warn about any side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with a brief introductory sentence followed by a bullet list of output fields. It is front-loaded with the purpose and uses minimal words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description adequately explains what the tool returns (list of decade periods with specific attributes). It covers the key output elements, though it does not specify the exact data structure (e.g., JSON format). Still, it is sufficient for understanding the return value.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with each parameter described in the schema. The description does not add new meaning beyond the schema; it focuses on the output, not the parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it lists the lifelong decade periods (大限周期) with specific fields (starting virtual age, Gregorian years, palace name, main stars, four transformations). This distinguishes it from sibling tools that cover yearly, monthly, or daily fortunes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies it is used for understanding the overall framework of life stages, but it does not explicitly state when to use this tool versus alternatives (e.g., ziwei_basic, ziwei_liunian). No when-not or alternative guidance is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ziwei_liunianB

紫微流年列表。

返回指定年份范围内的流年信息:

  • 公历年份

  • 干支年

  • 虚岁

  • 流年宫位

  • 宫内主星

  • 所属大限

  • 流年四化

用于分析多年运势趋势。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
startYearYesStart year for the range
endYearYesEnd year for the range

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It describes return fields but does not disclose any side effects, limitations (e.g., maximum year range), or required external context (e.g., that birth data is used to compute the base chart). The tool appears to be read-only, but this is not explicitly stated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise: a single sentence stating purpose, followed by a bullet list of returned fields. Every element adds value, and there is no extraneous information. It is front-loaded with the main action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of 11 parameters and no output schema, the description covers the basic output but lacks context on how to interpret the results (e.g., meaning of 流年四化) or how this tool fits into the larger Zi Wei Dou Shu workflow. It is adequate but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for all 11 parameters, so the baseline is 3. The description adds no extra meaning to parameters beyond what is already in the schema; it only lists output fields. Therefore, it does not improve parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it returns a '紫微流年列表' (Ziwei annual flow list) for a specified year range, listing specific fields like year, Gan-Zhi, and stars. This distinguishes it from sibling tools focused on daily (liuri), monthly (liuyue), or decade (daxian) periods, though it doesn't explicitly name them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description states it is '用于分析多年运势趋势' (used for analyzing multi-year fortune trends), implying its use for trend analysis. However, it does not explicitly indicate when to use this tool versus alternatives like ziwei_liuri or ziwei_liuyue, or any prerequisites like needing a natal chart first.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ziwei_liuriA

紫微流日列表。

返回指定农历月内的每日运势(含上下文):

  • 当前大限、小限、流年、流月资讯

  • 农历日期与公历日期对照

  • 干支日及流日宫位

  • 完整四化系统(本命/大限/小限/流年/流月/流日)

闰月使用负数表示(如 -6 表示闰六月)。

用于精细的日期选择。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
lunarYearYesThe lunar year (Gregorian year)
lunarMonthYesLunar month (1-12, use negative for leap month, e.g. -6 for leap 6th month)

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It clearly explains the output includes current periods (大限, 小限, 流年, 流月, 流日), calendar conversion, ganzhi days, and the complete four-transformation system. It also notes the special representation of leap months with negative numbers. This provides good behavioral context beyond just stating it lists daily fortunes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single paragraph with bullet points, making it somewhat structured. However, it is a bit verbose with excessive punctuation and line breaks. Each sentence serves a purpose, but the formatting is not ideal for quick scanning. It could be more concise by removing redundant phrasing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 11 parameters, no output schema, and no annotations, the description is fairly complete. It explains the output content (daily fortunes, calendar data, transformations) and a special behavior (leap month representation). It does not explain the return format or pagination, but the listed items give a good understanding of what to expect. For a complex tool, this is adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so every parameter has a description in the schema. The description itself adds minimal extra semantic value beyond what the schema already provides. It reiterates the leap month convention, which is already in the schema's description for 'lunarMonth'. There is no significant additional detail about parameter relationships or formatting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool provides a list of daily fortunes for a specified lunar month, including various calendar and astrological details. It clearly identifies the resource (daily flow) and verb (list). While it distinguishes from siblings like 'ziwei_liunian' and 'ziwei_liuyue' by focusing on '流日', it does not explicitly compare with all siblings, leaving some ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description mentions '用于精细的日期选择' (used for fine date selection), implying usage context. However, it does not provide explicit guidance on when to use this tool versus alternatives like 'ziwei_basic' or 'bazi_liuri', nor does it mention any prerequisites or limitations. The context is implied but not fully explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ziwei_liuyueA

紫微流月列表。

重要:紫微流月使用【农历月】,非节气月!

  • 以农历初一为边界

  • 正月从春节开始

  • 闰月单独显示(如"闰六月")

返回指定年份的流月运势(含上下文):

  • 当前大限、小限、流年资讯

  • 农历月份及公历日期范围

  • 流月宫位及宫内主星

  • 完整四化系统(本命/大限/小限/流年/流月)

用于规划年度活动时机。

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
lunarYearYesThe lunar year (Gregorian year) to query

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses key behaviors: uses lunar months, returns specific items like current year, month, and fortune details. However, it does not mention permissions, rate limits, or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is fairly concise and organized with bullet points, front-loading the key point about lunar months. Minor redundancy could be trimmed, but overall good.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (10 params, no output schema), the description provides a good overview of what the tool does and returns. It could explain some parameters like longitude and the output format more, but it's adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description does not add significant meaning beyond the schema; it focuses on output rather than parameter details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns '流月运势' (monthly fortunes) for a given year, using lunar months. It distinguishes from sibling tools by specifying it's about monthly fortunes, while siblings cover basic, day, hour, etc.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description mentions '用于规划年度活动时机' (used for planning annual activity timing) and emphasizes using lunar months. However, it does not explicitly state when to use this tool versus alternatives or when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ziwei_xiaoxianB

紫微小限列表。

小限是紫微斗数中的年度运限单位,每年一宫:

  • 虚岁(1岁起)

  • 对应公历年份

  • 小限宫位(根据出生年支起宫,男顺女逆)

  • 宫内主星

  • 所属大限

  • 小限四化

小限与流年并列但计算方式不同:

  • 小限:以出生年支定起宫,逐年移宫

  • 流年:以该年地支定宫位

层级顺序:大限 > 小限 > 流年 > 流月 > 流日

ParametersJSON Schema
NameRequiredDescriptionDefault
yearYesBirth year (e.g., 1990)
monthYesBirth month (1-12)
dayYesBirth day (1-31)
hourYesBirth hour in 24-hour format (0-23)
minuteNoBirth minute (0-59)
genderYesGender for fortune direction calculation
longitudeNoBirth location longitude for true solar time adjustment
isLunarNoWhether the input date is in lunar calendar (農曆). If true, will be converted to solar calendar internally.
nameNoSubject name (optional)
startAgeYesStart age (nominal age) for the range
endAgeYesEnd age (nominal age) for the range

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must disclose all behavioral traits. It does not mention return format, error handling, mutability, or side effects. The tool likely returns a list, but no output schema or description of response is given, leaving behavior opaque.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is well-structured with bullet points, concise at about 10 lines, and front-loaded with a clear definition. Every sentence adds value except perhaps some redundancy in the calculation comparison.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 11 parameters and no output schema, the description is incomplete. It explains the concept well but lacks details on output structure, pagination, or how results are returned. For a complex tool, more completeness is needed, especially about the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. Description adds no further parameter-specific details beyond what the schema provides. The general explanation of 小限 adds context but does not enhance parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states tool lists '紫微小限' (minor limit) and defines it as an annual fortune unit with specific attributes. It distinguishes from '流年' (yearly flow) and mentions hierarchy, but does not explicitly differentiate from sibling tools like 'ziwei_daxian' or 'ziwei_liunian', which hampers precise purpose clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description provides context on what 小限 is and contrasts it with 流年, implying when to use. However, it lacks explicit guidance on when to use this tool versus other Zi Wei tools (e.g., for major limits or daily flow), and no prerequisites or exclusions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 17 tool updatesv0.1.3
    • First observedbazi_basic
    • First observedbazi_dayun
    • First observedbazi_liunian
    • First observedbazi_liuri
    • First observedbazi_liuyue
    • First observeddaliuren_basic
    • First observedliuyao_basic
    • First observedmeihua_basic
    • First observedqimen_basic
    • First observedqimen_yongshen
    • First observedqimen_zeri
    • First observedziwei_basic
    • First observedziwei_daxian
    • First observedziwei_liunian
    • First observedziwei_liuri
    • First observedziwei_liuyue
    • First observedziwei_xiaoxian

TDQS

A4/5.0
Disambiguation5/5

Each tool targets a distinct function within its respective divination system (e.g., basic charting vs. yearly/monthly/daily analysis). The systematic prefix (bazi_, ziwei_, qimen_, etc.) ensures clear differentiation across systems, with no overlapping purposes.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern using snake_case: system prefix + descriptive suffix (e.g., bazi_basic, qimen_zeri). No mixing of conventions; the pattern is uniform across 17 tools.

Tool Count5/5

With 17 tools covering six different divination systems, the count is well-scoped for the server's purpose. Each system has a core set of tools (basic + lifecycle analysis), and no excessive or trivial tools exist.

Completeness4/5

The tool set provides comprehensive coverage for bazi and ziwei (including yearly, monthly, daily, and decade luck), and qimen (basic, use-spirit analysis, and date selection). However, daliuren, liuyao, and meihua have only basic charting tools, leaving some advanced analysis gaps.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides five Chinese metaphysics engines (BaZi, QMDJ, ZWDS, Feng Shui, I Ching) as MCP tools for analysis and forecasting.
    6
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables traditional Chinese metaphysics tools like Bazi, Ziwei, and Qimen via MCP, integrating AI analysis for divination and fortune-telling.
    516
    -
  • A
    license
    A
    quality
    A
    maintenance
    Provides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.
    5
    97
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides 35 MCP tools for Chinese metaphysical divination, including BaZi, ZiWei, QiMen, and daily fortune subscriptions, enabling AI agents to perform complex fortune-telling and calendar predictions.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ChesterRa/mingpan'

If you have feedback or need assistance with the MCP directory API, please join our Discord server