divination-chart-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@divination-chart-mcpgenerate a bazi chart for 1990-03-15 14:00"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
占卜排盘 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-mcp2. 安装依赖
uv sync3. 启动 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-mcpMCP 配置
{
"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 3000api/index.py导出了同一个 ASGI app,可用于云平台部署也可以直接在 Vercel 上部署这个项目,使用的是
vercel.json配置文件
Available Tools
2 toolsdivination_baziB
八字排盘工具 - 根据年月日时及性别,进行八字排盘,返回八字盘面的详细信息和启发性的分析。
| Name | Required | Description | Default |
|---|---|---|---|
| input_data | Yes | 八字排盘的输入参数 |
Output Schema
| Name | Required | Description |
|---|---|---|
| personal_info | Yes | 个人基本信息 |
| natal_chart | Yes | 八字命盘(静态信息) |
| luck_cycles | Yes | 大运小运流年(动态信息) |
| target_flow | Yes | 指定时间的流年月日时 |
| heuristic_analysis | Yes | 盘面启发式分析结果,不作为最终结论,仅供参考 |
TDQS
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.
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.
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.
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.
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.
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
六爻排盘工具 - 根据年月日时进行六爻占卜排盘,返回六爻盘面的详细信息。
| Name | Required | Description | Default |
|---|---|---|---|
| input_data | Yes | 六爻排盘的输入参数,公历的年月日时24时制数字数字 |
Output Schema
| Name | Required | Description |
|---|---|---|
| yaogua | Yes | 摇卦的原始记录数组,表示6次摇卦的结果,从初爻到上爻排列,对解卦无用处,仅供参考 |
| time | Yes | 起卦的详细时间,格式:YYYY-MM-DD HH:MM:SS |
| bazi | Yes | 起卦时间的干支(四柱) |
| yuejian | Yes | 月建,月柱的地支 |
| richen | Yes | 日辰, 日柱的地支 |
| kongwang | Yes | 日柱对应的旬中空亡 |
| guashen | Yes | 卦身 |
| chuangzhang | Yes | 床帐 |
| xianggui | Yes | 香闺 |
| shensha | Yes | 卦象中的神煞信息数组 |
| benguaming | Yes | 本卦卦名 |
| guagong | Yes | 本卦所属的卦宫 |
| bengua_type | Yes | 本卦的特殊类型 |
| bianguaming | Yes | 变卦(之卦)的卦名 |
| biangua_type | Yes | 变卦的特殊类型 |
| yao_1 | Yes | 初爻(最下爻)详细信息 |
| yao_2 | Yes | 二爻详细信息 |
| yao_3 | Yes | 三爻详细信息 |
| yao_4 | Yes | 四爻详细信息 |
| yao_5 | Yes | 五爻详细信息 |
| yao_6 | Yes | 上爻(最上爻)详细信息 |
TDQS
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.
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.
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.
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.
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.
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
Two tools cover distinct divination methods (bazi vs liuyao); descriptions clarify their differences, so no confusion.
Both tools follow the same 'divination_' prefix plus descriptive type name in snake_case, ensuring predictable pattern.
Two tools is appropriate for a niche domain focused on specific chart types; slightly low but not unreasonable.
Covers two major Chinese divination methods; could include others like ziwei but current scope is coherent and sufficient.
Maintenance
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
An MCP server that automatically collects feedback on your MCP server.
An MCP server that used to create notes
An MCP server for weather information by @kulybaba
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for accurate Bazi calculations, enabling personality analysis, destiny forecasting, and Chinese calendar queries via AI agents.286ISC
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for Chinese traditional calendar functions, including BaZi calculation, calendar conversion, Huangli query, daily fortune, solar terms, and Wu Xing analysis.5MIT
- AlicenseAqualityBmaintenanceA fortune-telling MCP server that generates traditional Chinese-style HTML reports for Ba Zi, Liu Yao, fortune sticks, naming, and a programmer's almanac.64MIT
- AlicenseAqualityAmaintenanceMCP 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.54MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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