Bazi MCP
Provides accurate Chinese Bazi (八字) fortune-telling calculations including birth chart analysis, destiny forecasting, and Chinese calendar information. Addresses inaccuracies in existing AI fortune-telling tools by delivering precise Bazi data for pe
What is Bazi MCP?
Bazi MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides accurate chinese bazi (八字) fortune-telling calculations including birth chart analysis, destiny forecasting, and chinese calendar information. addresses inaccuracies in existing ai fortune-te...
Provides accurate Chinese Bazi (八字) fortune-telling calculations including birth chart analysis, destiny forecasting, and Chinese calendar information. Addresses inaccuracies in existing AI fortune-telling tools by delivering precise Bazi data for pe
This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides accurate Chinese Bazi (八字) fortune-telling calculat
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bazi-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bazi MCP
The Bazi MCP server provides precise Chinese Bazi (八字) fortune-telling calculations that address the systematic inaccuracies found in general-purpose AI models when handling traditional Chinese astrology. It exposes three tools — getBaziDetail, getSolarTimes, and getChineseCalendar — which respectively compute an individual's eight-character birth chart with ten gods and fortune periods, reverse-convert a Bazi combination to matching solar dates, and retrieve traditional Chinese almanac data for any given day. Built with TypeScript and distributed via npm, it integrates cleanly into any MCP-compatible AI assistant, turning it into a reliable tool for Bazi analysis, astrological consulting, or Chinese calendar lookups.
Prerequisites
- Node.js 22 or higher
- npm or npx available on your PATH
- An MCP-compatible client such as Claude Desktop or Claude Code
Install via Smithery (recommended for Claude Desktop)
The easiest way to add bazi-mcp to Claude Desktop is through the Smithery CLI, which handles configuration automatically.
npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claudeOr configure Claude Desktop manually
Add the server entry directly to your Claude Desktop configuration file. No API keys or environment variables are required.
Restart Claude Desktop
After editing the configuration file, restart Claude Desktop completely so it picks up the new server entry.
Verify the tools are available
Ask Claude to list the available MCP tools or try a simple Bazi query to confirm the server is connected and responding.
Bazi MCP Examples
Client configuration
Manual Claude Desktop configuration for bazi-mcp. No environment variables are required; the server uses npx to run the package on demand.
{
"mcpServers": {
"Bazi": {
"command": "npx",
"args": ["bazi-mcp"]
}
}
}Prompts to try
Example questions you can ask once bazi-mcp is connected. The server accepts ISO 8601 date-times and returns full Bazi profiles.
- "Calculate the Bazi chart for a male born on July 31, 1998 at 14:10 CST"
- "What are the ten gods and fortune periods for someone born on 1990-03-20T08:00:00+08:00?"
- "Convert the Bazi pillars 甲子 乙丑 丙寅 丁卯 to possible solar calendar dates"
- "What does the Chinese almanac say about today? Is it auspicious for signing contracts?"
- "Show me the lunar date and zodiac clash information for 2025-02-14"Troubleshooting Bazi MCP
npx bazi-mcp fails with a package not found error
Ensure Node.js 22+ is installed ('node --version'). Try 'npx -y bazi-mcp' with the -y flag to auto-accept the install prompt, or install globally first with 'npm install -g bazi-mcp'.
getBaziDetail returns unexpected results for late-night birth times
Late-night hours (before midnight) are ambiguous in the Chinese hour system. Adjust the eightCharProviderSect parameter: use 1 for the traditional single-day sect or 2 (default) for the two-day sect. The correct value depends on regional convention.
The server does not appear in Claude Desktop after configuration
Verify that your claude_desktop_config.json is valid JSON with no trailing commas. Restart Claude Desktop fully (quit from the menu bar on macOS, not just close the window) after any config change.
Frequently Asked Questions about Bazi MCP
What is Bazi MCP?
Bazi MCP is a Model Context Protocol (MCP) server that provides accurate chinese bazi (八字) fortune-telling calculations including birth chart analysis, destiny forecasting, and chinese calendar information. addresses inaccuracies in existing ai fortune-telling tools by delivering precise bazi data for pe It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bazi MCP?
Follow the installation instructions on the Bazi MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Bazi MCP?
Bazi MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bazi MCP free to use?
Yes, Bazi MCP is open source and available under the ISC License license. You can use it freely in both personal and commercial projects.
Bazi MCP Alternatives — Similar Data Science & ML Servers
Looking for alternatives to Bazi MCP? Here are other popular data science & ml servers you can use with Claude, Cursor, and VS Code.
Ultrarag
★ 5.6kA Low-Code MCP Framework for Building Complex and Innovative RAG Pipelines
RocketRide
★ 3.1k📇 🏠 - MCP server that exposes RocketRide AI pipelines as t
Aix Db
★ 2.1kAix-DB 基于 LangChain/LangGraph 框架，结合 MCP Skills 多智能体协作架构，实现自然语言到数据洞察的端到端转换。
NeMo Data Designer
★ 1.9k🎨 NeMo Data Designer: Generate high-quality synthetic data from scratch or from seed data.
PaperBanana
★ 1.7kOpen source implementation and extension of Google Research’s PaperBanana for automated academic figures, diagrams, and research visuals, expanded to new domains like slide generation.
MiniMax
★ 1.5kBridges MiniMax AI capabilities to the Model Context Protocol, enabling AI agents to perform image understanding, text-to-image generation, and speech synthesis. It provides a standardized interface for accessing MiniMax's core tools via JSON-RPC.
Browse More Data Science & ML MCP Servers
Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bazi MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bazi MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.