MCPgee
MCPgee
MCPgeeMCPgee

Mingyu

v1.0.0•APIs•stable

八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式排盘，输出结构化提示词与数据。提供公开 API、MCP Server 与 skill。

aibazida-liurendivinationfortune-telling
Share:
95
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Mingyu?

Mingyu is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式排盘，输出结构化提示词与数据。提供公开 api、mcp server 与 skill。

八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式排盘，输出结构化提示词与数据。提供公开 API、MCP Server 与 skill。

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式排盘，输出结构化提示词与数据。提供公开

Use Cases

Divination and fortune-telling calculations
Structured chart and reading data output
API and MCP server access for Eastern practices
Brhiza

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mingyu

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Mingyu

Mingyu (命语) is a comprehensive Chinese divination and fortune-telling MCP server that provides structured chart calculations and AI-ready prompt generation for over a dozen traditional practices — including Bazi (eight characters), Zi Wei Dou Shu (Purple Star Astrology), Western astrology, Liu Yao (hexagram divination), Mei Hua Yi Shu, Qi Men Dun Jia, Da Liu Ren, Xiao Liu Ren, Tarot, Lenormand, and Ling Qian (temple oracle). It connects AI assistants to the public API at aov.cc and the local MCP server so that chart data is returned as machine-readable structured output alongside natural-language prompts ready for LLM interpretation. Developers can integrate it into agents, workflows, or applications without manually constructing the complex calculation logic behind each divination system.

Prerequisites

  • Node.js 18 or later installed on your system
  • Git to clone the repository
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
  • Optional: access to the public API at https://aov.cc/api/v1 (no key required for public endpoints)
1

Clone the repository

Clone the Mingyu repository from GitHub to your local machine. The project is a TypeScript/React application with a dedicated MCP server under the mcp/ directory.

git clone https://github.com/Brhiza/mingyu.git
cd mingyu
2

Install dependencies

Install all Node.js dependencies required by the project including the MCP server and front-end build tooling.

npm install
3

Start the MCP server

Launch the built-in MCP server using the npm script. The server communicates over stdio and exposes all divination tools to your MCP client.

npm run mcp
4

Configure your MCP client

Add the Mingyu MCP server to your client configuration file. For Claude Desktop, edit claude_desktop_config.json and point the command at the npm script inside the cloned directory.

5

Verify the connection

Open your MCP client and check that the Mingyu tools appear in the available tools list. You should see tools for Bazi, Zi Wei, astrology, hexagram, Tarot, and more. Try a simple query such as asking for a Bazi chart to confirm the server is responding.

Mingyu Examples

Client configuration

Claude Desktop configuration pointing to the locally cloned Mingyu repository. Replace /path/to/mingyu with the actual path where you cloned the repo.

{
  "mcpServers": {
    "mingyu": {
      "command": "npm",
      "args": ["run", "mcp"],
      "cwd": "/path/to/mingyu"
    }
  }
}

Prompts to try

Sample prompts that use the Mingyu divination tools once the server is connected to your AI assistant.

- "Generate a Bazi (eight characters) chart for someone born on 1990-05-15 at 14:30 Beijing time"
- "Cast a Liu Yao (hexagram) reading for a question about a career change using the current time"
- "Draw a three-card Tarot spread for a question about a new relationship"
- "Produce a Zi Wei Dou Shu (Purple Star) natal chart for birth date 1985-03-22 hour Mao"
- "Give me a Qi Men Dun Jia chart for right now to assess a business decision"

Troubleshooting Mingyu

The MCP server starts but no tools appear in the client

Ensure the cwd in your client config points to the root of the cloned mingyu repository so that npm run mcp can find the package.json. Also confirm npm install completed without errors.

npm run mcp exits immediately with a module-not-found error

Run npm install again from the project root to ensure all dependencies including the MCP SDK are present. The project requires Node.js 18 or later — verify your version with node --version.

Chart calculations return unexpected results or errors for certain birth times

Divination methods that depend on the current time (Liu Yao, Mei Hua, Qi Men, Da Liu Ren, Xiao Liu Ren) accept an optional customDate parameter in ISO 8601 format with timezone offset (e.g. 2025-06-10T14:30:00+08:00). Pass this explicitly to override the default system time.

Frequently Asked Questions about Mingyu

What is Mingyu?

Mingyu is a Model Context Protocol (MCP) server that 八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式排盘，输出结构化提示词与数据。提供公开 api、mcp server 与 skill。 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mingyu?

Follow the installation instructions on the Mingyu GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Mingyu?

Mingyu works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mingyu free to use?

Yes, Mingyu is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Mingyu Alternatives — Similar APIs Servers

Looking for alternatives to Mingyu? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.

Kong

★ 43.4k

🦍 The API and AI Gateway

API Mega List

★ 5.4k

This GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪

Fetch

★ 5.4k

Fetch web content and convert to markdown for AI consumption

Fusio

★ 2.1k

Self-Hosted API Management for Builders

Korean Law

★ 1.8k

국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools

RuleGo

★ 1.5k

⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

APIsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mingyu": { "command": "npx", "args": ["-y", "mingyu"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Mingyu?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides