易数洞察 · Yishu Insight MCP Server

Deterministic I Ching and Zi Wei Dou Shu for AI agents.

English · 中文 · 日本語

English

yishu-insight-mcp is the MCP server for Yishu Insight (易数洞察). It gives your AI agent two classical Chinese systems, computed by code and not by the model:

• I Ching (Book of Changes). 64 hexagrams. Three-coin and Plum Blossom (time-based) casting. Original, mutual, opposite, reversed and changed hexagrams. Full classical texts and moving-line readings. Runs locally and works offline.

• Zi Wei Dou Shu (Purple Star Astrology). 12 palaces, 14 main stars, 23 classical patterns, Four Transformations (flying stars), synastry, a 100-year Life K-Line, a classical texts knowledge base and famous charts. Powered by the authoritative Rust engine at insightapp.life.

The LLM never guesses a chart. If the engine is unreachable, the tool returns isError. It never invents a result. Zero runtime dependencies. Node 18 or newer.

Quick Start

1. Remote Streamable HTTP (zero install)

Endpoint: https://insightapp.life/mcp

Claude Desktop, Cursor, Windsurf and Cline:

{
  "mcpServers": {
    "yishu-insight": { "url": "https://insightapp.life/mcp" }
  }
}

ChatGPT / OpenAI: add https://insightapp.life/mcp as a remote MCP server (ChatGPT connectors in developer mode, or the mcp tool of the OpenAI Responses API with server_url). No auth needed.

2. Local stdio via NPX

{
  "mcpServers": {
    "yishu-insight": {
      "command": "npx",
      "args": ["-y", "yishu-insight-mcp"]
    }
  }
}

Options: --remote-url <url> (or env YISHU_INSIGHT_URL) sets the engine for ziwei_* tools. Also --help and --version. Note: local ziwei_* tools need network access to the engine. iching_* tools never do.

Tools

iching_cast returns ben, hu, cuo, zong, bian (null if no moving line), rule, moving_line_texts, ti_yong and decision_guidance. ziwei_chart returns { source, request, result }. result holds 12 palaces, 命/身宫, five-element bureau, main stars, patterns, feixing and decade/annual cycles.

Prompts: iching_divination_prompt, ziwei_chart_reading_prompt. Resources: yishu://hexagrams/index, yishu://guide/methodology.

Try it in the browser

• Zi Wei chart: https://insightapp.life/ziwei/chart

• I Ching divination: https://insightapp.life/zhouyi/divine

• Synastry: https://insightapp.life/ziwei/heming

• Life K-Line: https://insightapp.life/ziwei/life-kline

Develop

npm test            # node --test, spawns the real stdio server
npm pack --dry-run
docker build -t yishu-insight-mcp .

MIT licensed. Divination is for cultural and reflective use. It is not medical, legal or financial advice.

Related MCP server: 知耘排盘 MCP Server

中文

易数洞察 MCP Server (yishu-insight-mcp) 把周易与紫微斗数交给代码计算,而不是交给大模型"推演"。

核心特性

• 零依赖确定性引擎。 起卦、排盘全部由程序算出,杜绝大模型算命幻觉。Node ≥ 18,零第三方依赖。

• 周易。 六十四卦;三枚铜钱与梅花易数(时间)起卦;本卦、互卦、错卦、综卦、变卦;卦辞、彖传、大象、爻辞与动爻取辞;体用与决策提示。本地运行,离线可用。

• 紫微斗数。 公历生日自动转农历,支持真太阳时与闰月;十二宫、十四主星、23 大经典格局;四化飞星;双人合盘;百岁人生 K 线;《紫微斗数全书》《骨髓赋》等古籍检索;名人命盘库。

• 诚实失败。 排盘引擎不可达时明确返回 isError,绝不伪造星盘。

快速接入

一、远程免安装(Streamable HTTP):https://insightapp.life/mcp

适用于 Claude Desktop、Cursor、Windsurf、Cline、Cherry Studio:

{
  "mcpServers": {
    "yishu-insight": { "url": "https://insightapp.life/mcp" }
  }
}

Cherry Studio:设置 → MCP 服务器 → 添加,类型选 streamableHttp,URL 填 https://insightapp.life/mcp。

二、本地 stdio(NPX)

{
  "mcpServers": {
    "yishu-insight": {
      "command": "npx",
      "args": ["-y", "yishu-insight-mcp"]
    }
  }
}

配置位置:Claude Desktop 为 claude_desktop_config.json;Cursor 为 ~/.cursor/mcp.json;Cline 为 cline_mcp_settings.json;Claude Code 运行 claude mcp add yishu-insight -- npx -y yishu-insight-mcp。

可选参数:--remote-url <url> 或环境变量 YISHU_INSIGHT_URL 指定排盘引擎地址。本地模式下 ziwei_* 需要联网,iching_* 完全离线。

7 大工具

示例:

{ "name": "ziwei_chart", "arguments": { "solar_date": "1990-06-15", "birth_time": "09:30", "gender": "female" } }

另有提示词 iching_divination_prompt、ziwei_chart_reading_prompt,资源 yishu://hexagrams/index、yishu://guide/methodology。

在线体验

• 紫微排盘:https://insightapp.life/ziwei/chart

• 周易占卜:https://insightapp.life/zhouyi/divine

• 双人合盘:https://insightapp.life/ziwei/heming

• 人生 K 线:https://insightapp.life/ziwei/life-kline

繁體中文使用者:以上設定與工具完全相同,網站可於語言選單切換「繁體中文」。

声明:本工具用于文化研究与自我反思,不构成医疗、法律或投资建议。MIT 许可。

日本語

易数インサイト MCP サーバー (yishu-insight-mcp) は、易経と紫微斗数の計算をコードに任せ、LLM に推測させません。

特徴

• 決定論的エンジン。 卦も命盤もプログラムが計算するため、LLM のハルシネーションが入りません。Node 18 以上、依存パッケージなし。

• 易経。 64 卦。六爻(三枚コイン)と梅花心易(時刻)による占筮。本卦・互卦・錯卦・綜卦・変卦。卦辞・彖伝・大象・爻辞、体用、判断のヒント。ローカルで動作し、オフラインでも使えます。

• 紫微斗数。 新暦から旧暦への自動変換(閏月・真太陽時対応)。十二宮、14 主星、23 格局、四化飛星、相性診断(合盤)、100 年人生 K ライン、『紫微斗数全書』『骨髄賦』などの古典検索、著名人の命盤。

• 正直な失敗。 エンジンに接続できない場合は isError を返し、命盤を捏造しません。

クイックスタート

1. リモート MCP(インストール不要):https://insightapp.life/mcp

Claude Desktop / Cursor / Windsurf / Cline:

{
  "mcpServers": {
    "yishu-insight": { "url": "https://insightapp.life/mcp" }
  }
}

2. ローカル stdio(npx)

{
  "mcpServers": {
    "yishu-insight": {
      "command": "npx",
      "args": ["-y", "yishu-insight-mcp"]
    }
  }
}

設定ファイル: Claude Desktop は claude_desktop_config.json、Cursor は ~/.cursor/mcp.json、Claude Code は claude mcp add yishu-insight -- npx -y yishu-insight-mcp。

--remote-url <url>(または環境変数 YISHU_INSIGHT_URL)でエンジンの URL を変更できます。ローカルでも ziwei_* はネットワークが必要で、iching_* は不要です。

ツール一覧(7 種)

呼び出し例:

{ "name": "iching_lookup", "arguments": { "upper": "坤", "lower": "乾" } }

Web 版で試す

• 命盤: https://insightapp.life/ziwei/chart

• 易経占い: https://insightapp.life/zhouyi/divine

• 合盤: https://insightapp.life/ziwei/heming

• 人生 K ライン: https://insightapp.life/ziwei/life-kline

本ツールは文化的な学びと内省のためのものです。医療・法律・投資の助言ではありません。MIT ライセンス。