shunshi-ai/bazi-reader-mcp

Overview

An open-source Model Context Protocol (MCP) server that enables AI agents to read and interpret Chinese Bazi charts. Written in TypeScript, it provides a standardized interface for agents to request and receive Bazi readings.

Best for

Best for
Developers prototyping AI agents that need to incorporate traditional Chinese Bazi readings

Use cases

• Integrate Bazi chart interpretation into conversational AI assistants
• Enable AI agents to fetch and parse traditional Chinese fortune-telling data
• Build cultural heritage or educational applications using Bazi readings

How to use

Install

npx -y shunshi-bazi-mcp

Tools exposed

• getBaziChart
• getHuangli

Tested with

Claude Desktop, Cursor, Cline

Example client config

[object Object]

Notes

An open-source Model Context Protocol (MCP) server that enables AI agents to read and interpret Chinese Bazi charts. Written in TypeScript, it provides a standardized interface for agents to request and receive Bazi readings.

4 stars on GitHub. Last updated 2026-05-31. Licensed MIT.

Use cases

• Integrate Bazi chart interpretation into conversational AI assistants
• Enable AI agents to fetch and parse traditional Chinese fortune-telling data
• Build cultural heritage or educational applications using Bazi readings

Pros

• Open source with a standard MCP interface for easy integration
• Written in TypeScript for type safety and modern development
• Focuses on a specific niche with clear domain logic

Cons

• Small community and limited support (4 stars on GitHub)
• Applicable only to Chinese Bazi astrology, not general-purpose
• Requires MCP-compatible AI agent infrastructure to use

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.