How do I install the guanxing mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GUANXING_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Guanxing MCP Server

MCP server for 观星 (GuanXing) — AI-powered Chinese metaphysics tools (BaZi, Tarot, I-Ching, Feng Shui, and more)

Local serverstdio

What is the Guanxing MCP Server?

MCP server for 观星 (GuanXing) — AI-powered Chinese metaphysics tools (BaZi, Tarot, I-Ching, Feng Shui, and more)

What it actually does

Give your AI assistant access to BaZi (八字), Tarot, I-Ching divination (求签), Feng Shui, dream interpretation, Chinese almanac, and more — all through the Model 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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Guanxing MCP Server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
GUANXING_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Guanxing MCP to Cursor.”
“Use Guanxing MCP to Windsurf.”

Frequently asked questions

MCP server for 观星 (GuanXing) — AI-powered Chinese metaphysics tools (BaZi, Tarot, I-Ching, Feng Shui, and more) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.