QiyueAstro MCP Server 🎴☯️

MCP (Model Context Protocol) server for Eastern & Western divination — tarot, Lenormand, I Ching, Meihua, Qi Men, BaZi, Zi Wei Dou Shu, Xiao Liu Ren and Da Liu Ren.

Works with Claude Desktop, Cursor, OpenClaw, Zed and any MCP client. No API key, no signup — data comes from the free QiyueAstro public API.

✨ Tools

Related MCP server: 命盘 Mingpan

🚀 Install

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "qiyue": {
      "command": "npx",
      "args": ["-y", "github:BloodymaryGG/qiyue-mcp"]
    }
  }
}

Cursor

Settings → MCP → Add new server:

Name: qiyue
Type: command
Command: npx -y github:BloodymaryGG/qiyue-mcp

OpenClaw

openclaw mcp add qiyue -- npx -y github:BloodymaryGG/qiyue-mcp

Manual (from source)

git clone https://github.com/BloodymaryGG/qiyue-mcp
cd qiyue-mcp
npm install
node index.mjs   # stdio MCP server

Test without a client

npm install
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node index.mjs

🧩 Example prompts

• "Draw a three-card tarot spread about my career"

• "Cast the I Ching — should I accept the job offer?"

• "What does The Tower card mean?"

• "Give me my BaZi chart for 1998-06-15 12:00, male"

• "小六壬看一下今天运势"

🌙 About QiyueAstro

QiyueAstro (栖月) — a full divination platform with 14 modules, AI-powered readings in 9 languages, free daily credits, and shareable reading cards. The MCP server above is a thin wrapper over its free public API.

📄 License

MIT. Card art is public-domain Rider-Waite-Smith line art.

Built with ❤️ by BloodymaryGG · qiyueastro.com