QiyueAstro MCP Server
MCP server for Eastern and Western divination, enabling tarot, Lenormand, I Ching, Meihua, Qi Men, BaZi, Zi Wei Dou Shu, Xiao Liu Ren and Da Liu Ren readings via the free QiyueAstro public API.
README
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
| Tool | Description |
|---|---|
draw_tarot |
Draw tarot cards — 13 spreads (single, three-card, celtic-cross, yes-or-no, love…) or N cards |
browse_tarot |
Browse the 78-card Rider-Waite deck, card details by id |
list_tarot_spreads |
List all available tarot spreads |
draw_lenormand |
Draw Lenormand cards — 8 spreads (three, relationship, decision, nine-card grid, grand-tableau…) |
browse_lenormand |
Browse the 36-card Lenormand deck |
cast_iching |
I Ching hexagram casting (coins / time / numbers), moving lines + changed hexagram |
get_hexagram |
Look up any of the 64 hexagrams (id or binary) |
cast_meihua |
Meihua Yishu casting (time / numbers) with Ti/Yong analysis |
cast_qimen |
Qi Men Dun Jia chart layout |
bazi_chart |
BaZi (Four Pillars) chart — pillars, WuXing counts, DaYun |
ziwei_chart |
Zi Wei Dou Shu chart — 12 palaces, major stars, brightness |
cast_xiaoliuren |
Xiao Liu Ren quick divination (Da An, Liu Lian, Su Xi…) |
cast_liuren |
Da Liu Ren lesson casting — four lessons, three transmissions |
🚀 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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.