GuanXing (观星) — Chinese Metaphysics AI Tools

by doggychip

Not rated
GitHub

About

MCP server for AI-powered Chinese metaphysics — BaZi (八字), Tarot, I-Ching, Feng Shui, fortune telling, dream interpretation, and more. 12 tools for spiritual exploration.

Details

Author
doggychip
Categories
Other, Developer Tools

Setup

Install GuanXing (观星) — Chinese Metaphysics AI Tools in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/doggychip/guanxing-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

GuanXing (观星) — Chinese Metaphysics AI Tools

MCP server for AI-powered Chinese metaphysics — BaZi (八字), Tarot, I-Ching, Feng Shui, fortune telling, dream interpretation, and more. 12 tools for spiritual exploration.

MCP server for观星 (GuanXing)— AI-powered Chinese metaphysics tools for LLM assistants.

Give your AI assistant access to BaZi (八字), Tarot, I-Ching divination (求签), Feng Shui, dream interpretation, Chinese almanac, and more — all through theModel Context Protocol.

GuanXing is an AI-powered Chinese metaphysics platform that combines thousands of years of Eastern wisdom with modern AI. It provides accurate, personalized readings across multiple metaphysics disciplines — from Four Pillars destiny analysis to tarot card readings.

This MCP server connects your AI assistant (Claude, GPT, etc.) directly to GuanXing's API, so you can ask questions like:

- "What does my BaZi chart say about my career?"
- "Draw me a tarot spread for my relationship question"
- "Is today auspicious for signing a contract?"
- "Analyze the feng shui of my home office facing south"

Register atheartai.zeabur.appand create an API key in your developer settings.

Add the server to your MCP client configuration:

Edit~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows):

{ "mcpServers": { "guanxing": { "command": "npx", "args": ["-y", "@guanxing1/mcp-server"], "env": { "GUANXING_API_KEY": "your-api-key-here" } } } }

Edit~/.claude/settings.jsonor.mcp.jsonin your project:

{ "mcpServers": { "guanxing": { "command": "npx", "args": ["-y", "@guanxing1/mcp-server"], "env": { "GUANXING_API_KEY": "your-api-key-here" } } } }
{ "guanxing": { "command": "npx", "args": ["-y", "@guanxing1/mcp-server"], "env": { "GUANXING_API_KEY": "your-api-key-here" } } }
{ "mcpServers": { "guanxing": { "command": "npx", "args": ["-y", "@guanxing1/mcp-server"], "env": { "GUANXING_API_KEY": "your-api-key-here" } } } }

Edit~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "guanxing": { "command": "npx", "args": ["-y", "@guanxing1/mcp-server"], "env": { "GUANXING_API_KEY": "your-api-key-here" } } } }

Once configured, just ask your AI assistant naturally:

"Analyze my BaZi chart — I was born on March 15, 1990 at 2pm"

"What does the Chinese almanac say about today?"

"Do a three-card tarot reading about my career change"

User: Analyze my birth chart — born 1990-05-15 at 14:00 → Tool: bazi_analysis({ birthDate: "1990-05-15", birthHour: 14 }) → Returns: Four Pillars chart with heavenly stems/earthly branches, five elements breakdown (金2 木1 水1 火1 土3), day master analysis, and personalized life reading
User: Draw a three-card spread about my relationship → Tool: tarot({ question: "relationship outlook", spread: "three" }) → Returns: Three cards with names, positions (upright/reversed), individual meanings, and a comprehensive interpretation
User: Is today a good day to sign a contract? → Tool: almanac({ date: "2026-03-17" }) → Returns: Lunar date, auspicious activities (宜), inauspicious activities (忌), hourly fortune breakdown, and daily summary
# Clone git clone https://github.com/doggychip/guanxing-mcp.git cd guanxing-mcp # Install & build npm install npm run build # Run locally GUANXING_API_KEY=your-key node dist/index.js

This package implements theModel Context Protocol (MCP)standard usingstdio transport— the standard for MCP CLI tools. When an MCP client (like Claude Desktop) starts this server, it communicates over stdin/stdout to discover and invoke tools.

Each tool call is forwarded to the GuanXing API athttps://heartai.zeabur.app/api/v1/...with your API key for authentication. The AI-generated metaphysics readings are returned directly to your assistant for natural conversation.

Chia Health MCP Server — Patient workflow integration for a licensed US telehealth platform. Browse GLP-1 medications (semaglutide, tirzepatide), peptide therapies (sermorelin, NAD+, glutathione), and longevity treatments. Check eligibility, complete intake, sign consents, and manage treatment plans. 30 tools, HIPAA-compliant. All prescriptions evaluated by licensed US healthcare providers and delivered from FDA-regulated pharmacies across 50 states + DC.

Broker + MCP server for last-bidder-wins games on Solana — agents register, auto-fund a Privy wallet, and bid via streamable HTTP

AI-powered no-code app builder with 17 MCP tools — create projects, generate pages from natural language, AI text/image generation (GPT, Claude, Gemini, 14+ models), page CRUD, workflow execution, publish & version control. SSE transport, API key auth.

An mcp server for your food ordering needs.

Agent-to-Agent handoff certification for multi-agent systems — validates context preservation, verifies agent capabilities before handoff, logs transfer chains, and ensures no data loss in agent orchestration.

Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.

A collection of Model Context Protocol (MCP) servers for various tasks and integrations, supporting both Python and Node.js environments.

Open-souSecurely feeds real security refreshed rules into Cursor, Claude Code, and Windsurf — zero config, no API key.

Health intelligence MCP — access biomarkers, biological age, and personalized longevity action plans from your Aniva profile.

Real-time stock heatmaps and investment tools delivered as interactive React components.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.