Zhouyi — Claude Code MCP server: features and setup
Zhouyi is an MCP server for Claude Code that provides I Ching and Zi Wei Dou Shu reference data. Ask the agent for a hexagram, an astrology star, or a classical text.
no license 1,315 installs updated 2026-02-18
claude mcp add --transport http zhouyi https://zhouyi.run.toolsWhat Zhouyi does
Zhouyi serves queries about I Ching hexagrams, Zi Wei Dou Shu stars, and classical works. A hexagram lookup accepts its ID; star records can be fetched by filename, and classics by ID. Each tool can also return a catalogue of available entries.
The data comes from the remote MCP endpoint https://zhouyi.run.tools, connected over HTTP. The Claude Code command registers it as zhouyi. Hexagram results include line interpretations, while star entries cover all 12 palaces.
What it helps with
- look up a hexagram by ID
- retrieve a star record by filename
- fetch the text of a classical work
Example prompts for the agent
- Look up hexagram 1 and explain its lines.
- Show the star record for
ZiWei. - Fetch the classic with ID 0.
How to install Zhouyi
Platform CLI: remote server
claude mcp add --transport http zhouyi https://zhouyi.run.toolsPlatform CLI: remote server
codex mcp add zhouyi --url https://zhouyi.run.toolsConfig file
{
"mcpServers": {
"zhouyi": {
"url": "https://zhouyi.run.tools"
}
}
}Config file
{
"servers": {
"zhouyi": {
"type": "http",
"url": "https://zhouyi.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http zhouyi https://zhouyi.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Zhouyi
How do I install Zhouyi in Claude Code?
Run claude mcp add --transport http zhouyi https://zhouyi.run.tools.
What does Zhouyi do?
It provides reference data for I Ching hexagrams, Zi Wei Dou Shu stars, and classical texts.
What does Zhouyi need to work?
Claude Code connects to the remote MCP endpoint at https://zhouyi.run.tools.