Skip to main content
Glama
wangsquirrel

divination-chart-mcp

by wangsquirrel

占卜排盘 MCP

这是一个用于生成占卜排盘(当前主要实现:六爻(Six-line)和八字(Bazi))的 MCP Server。

使用

依赖

  • Python 3.12+

  • uv

本地运行

1. Clone the repository

git clone https://github.com/wangsquirrel/divination-chart-mcp.git
cd divination-chart-mcp

2. 安装依赖

uv sync

3. 启动 stdio MCP server

uv run --with . divination-chart-mcp

也可以显式指定 transport:

uv run --with . divination-chart-mcp --transport stdio
uv run --with . divination-chart-mcp --transport sse
uv run --with . divination-chart-mcp --transport streamable-http

用 uvx 启动

本地仓库:

uvx --from . divination-chart-mcp

直接从 GitHub:

uvx --from git+https://github.com/wangsquirrel/divination-chart-mcp divination-chart-mcp

MCP 配置

{
  "mcpServers": {
    "divination-chart-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/wangsquirrel/divination-chart-mcp",
        "divination-chart-mcp"
      ]
    }
  }
}

测试MCP服务

uvx fastmcp list --command  'uv run --with . divination-chart-mcp' --json

部署服务

  • 使用 ASGI 服务器启动 SSE 服务:

uvicorn api.index:app --host 0.0.0.0 --port 3000
  • api/index.py 导出了同一个 ASGI app,可用于云平台部署

  • 也可以直接在 Vercel 上部署这个项目,使用的是 vercel.json 配置文件

Available Tools

2 tools
divination_baziB

八字排盘工具 - 根据年月日时及性别,进行八字排盘,返回八字盘面的详细信息和启发性的分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
input_dataYes八字排盘的输入参数

Output Schema

ParametersJSON Schema
NameRequiredDescription
personal_infoYes个人基本信息
natal_chartYes八字命盘(静态信息)
luck_cyclesYes大运小运流年(动态信息)
target_flowYes指定时间的流年月日时
heuristic_analysisYes盘面启发式分析结果,不作为最终结论,仅供参考

TDQS

B3.1/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 the full burden of behavioral disclosure. It only states that the tool returns 'detailed information and insightful analysis' but does not disclose whether it is read-only, destructive, requires authentication, or has rate limits. There is no mention of data handling or side effects, leaving behavioral traits unclear.

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 a single, concise sentence in Chinese (about 30 characters) that efficiently states the purpose and inputs. It is front-loaded with the tool's function. However, it could potentially include more structured information like usage context without sacrificing brevity.

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 the complexity of Bazi chart calculation, the description is insufficient for an AI agent unfamiliar with the concept. It does not explain what Bazi is, how the analysis is derived, or provide any background needed for correct selection. The existence of an output schema mitigates return value explanation, but the description still lacks necessary context for an informed choice.

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 schema description coverage is 100%, meaning all parameters already have clear descriptions in the schema. The tool description adds a brief summary ('the input parameters for Bazi chart calculation') but does not provide additional semantic meaning beyond what the schema offers. Baseline score of 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: perform Bazi chart calculation based on birth date/time and gender, returning detailed information and analysis. The verb '进行八字排盘' (perform Bazi chart calculation) is specific, and the resource '八字盘面' (Bazi chart) is well-defined. It distinguishes from the sibling tool 'divination_liu_yao', which is a different divination method.

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 any guidance on when to use this tool versus alternatives. It does not mention prerequisites, when not to use it, or specific contexts. The sibling tool is noted but not compared. An agent would have no explicit guidance on choosing between Bazi and Liu Yao divination.

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

divination_liu_yaoB

六爻排盘工具 - 根据年月日时进行六爻占卜排盘,返回六爻盘面的详细信息。

ParametersJSON Schema
NameRequiredDescriptionDefault
input_dataYes六爻排盘的输入参数,公历的年月日时24时制数字数字

Output Schema

ParametersJSON Schema
NameRequiredDescription
yaoguaYes摇卦的原始记录数组,表示6次摇卦的结果,从初爻到上爻排列,对解卦无用处,仅供参考
timeYes起卦的详细时间,格式:YYYY-MM-DD HH:MM:SS
baziYes起卦时间的干支(四柱)
yuejianYes月建,月柱的地支
richenYes日辰, 日柱的地支
kongwangYes日柱对应的旬中空亡
guashenYes卦身
chuangzhangYes床帐
xiangguiYes香闺
shenshaYes卦象中的神煞信息数组
benguamingYes本卦卦名
guagongYes本卦所属的卦宫
bengua_typeYes本卦的特殊类型
bianguamingYes变卦(之卦)的卦名
biangua_typeYes变卦的特殊类型
yao_1Yes初爻(最下爻)详细信息
yao_2Yes二爻详细信息
yao_3Yes三爻详细信息
yao_4Yes四爻详细信息
yao_5Yes五爻详细信息
yao_6Yes上爻(最上爻)详细信息

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description must bear the full burden of disclosure. It only states 'returns detailed information' without describing side effects (e.g., automatic coin toss if yaogua omitted). Behavioral traits are insufficiently communicated.

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 a single sentence that is efficiently front-loaded with the tool's purpose. No wasted words.

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 divination and the presence of an output schema, the description is minimally adequate. It lacks details on method (e.g., Chinese calendar or random generation) but covers basic inputs and output. Could improve by clarifying automatic coin toss behavior.

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%, and the parameter descriptions in the schema are detailed (e.g., valid ranges, yaogua behavior). The main description adds no extra meaning beyond what the schema provides, so baseline 3 is appropriate.

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 the tool performs Six Yao divination layout based on year, month, day, and hour, and returns detailed information. It distinguishes from the sibling tool 'divination_bazi' by method, though not explicitly stated, making it clear enough.

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?

No guidance on when to use this tool versus alternatives. The description does not mention any prerequisites or context for use, leaving the agent without direction on selecting between tools.

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

TDQS

A3.5/5.0
Disambiguation5/5

Two tools cover distinct divination methods (bazi vs liuyao); descriptions clarify their differences, so no confusion.

Naming Consistency5/5

Both tools follow the same 'divination_' prefix plus descriptive type name in snake_case, ensuring predictable pattern.

Tool Count4/5

Two tools is appropriate for a niche domain focused on specific chart types; slightly low but not unreasonable.

Completeness4/5

Covers two major Chinese divination methods; could include others like ziwei but current scope is coherent and sufficient.

Maintenance

ActivityInactive
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
    Not graded
    quality
    D
    maintenance
    MCP server for accurate Bazi calculations, enabling personality analysis, destiny forecasting, and Chinese calendar queries via AI agents.
    286
    ISC
  • A
    license
    A
    quality
    B
    maintenance
    A fortune-telling MCP server that generates traditional Chinese-style HTML reports for Ba Zi, Liu Yao, fortune sticks, naming, and a programmer's almanac.
    6
    4
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for ai-divination-skills that provides tools for tarot draws, I Ching casts, Xiao Liu Ren casts, and Bazi chart generation, returning auditable JSON results for AI interpretation.
    5
    4
    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/wangsquirrel/divination-chart-mcp'

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