# Zhouyi

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1315 installs
- Author: gobling
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/gobling/zhouyi
- Updated: 2026-02-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/zhouyi

## What it 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.

## Requirements
- Remote server: `https://zhouyi.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http zhouyi https://zhouyi.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add zhouyi --url https://zhouyi.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zhouyi": {
            "url": "https://zhouyi.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zhouyi": {
            "type": "http",
            "url": "https://zhouyi.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http zhouyi https://zhouyi.run.tools
```

## When to use it
- look up a hexagram by ID
- retrieve a star record by filename
- fetch the text of a classical work

## Example prompts
- Look up hexagram 1 and explain its lines.
- Show the star record for `ZiWei`.
- Fetch the classic with ID 0.

## Similar
- [Ziwei & Bazi Astrology](https://affpapa.org/en/nevibecode/mcp/ziwei-bazi-astrology.md) — MCP server · 976 installs
- [alexandria](https://affpapa.org/en/nevibecode/mcp/alexandria.md) — MCP server · 1422 installs
- [Horosa Skill](https://affpapa.org/en/nevibecode/mcp/horosa-skill.md) — MCP server · ★ 525 repo stars
- [astro](https://affpapa.org/en/nevibecode/mcp/astro.md) — MCP server · ★ 18 repo stars
- [Asterwise](https://affpapa.org/en/nevibecode/mcp/asterwise.md) — MCP server
- [celestine](https://affpapa.org/en/nevibecode/mcp/celestine.md) — MCP server · 2188 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
