Ziwei

Provides Ziwei chart calculations, time data, and fortune horizons via MCP-compatible endpoints.

javascript

3

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wuunicorn-mcpiztro": {
      "command": "node",
      "args": [
        "/path/to/your/project/ziwei_mcp_server.js"
      ],
      "env": {
        "NODE_PATH": "/path/to/your/project/node_modules"
      }
    }
  }
}

You can run a dedicated MCP server for 紫微斗数 calculations to deliver precise star charts and fortune analysis in any MCP-enabled assistant. This server provides full Ziwei DouShu charts, time handling, fortune windows, and structured JSON results that you can integrate into chatbots or automation flows.

How to use

Start the server locally and connect your MCP client to request the three core tools: current time, Ziwei chart calculation, and fortune trajectory. You can ask your MCP-enabled assistant to pull the current system time, generate a Ziwei chart for a given birth date and time, or fetch fortune data for a future date. Use natural language queries to drive these tools, for example asking for a chart for a specific birth moment or requesting the luck outlook for a particular year.

How to install

Prerequisites: ensure you have Node.js version 18.0.0 or higher and npm installed.

git clone https://github.com/wuunicorn/MCPIztro.git
cd MCPIztro
npm install

Additional setup and configuration

Create a configuration that points to the local MCP server script and sets the module path for dependencies. You will use a JSON configuration that includes an MCP server named ziwei with a stdio runtime.

{
  "mcpServers": {
    "ziwei": {
      "command": "node",
      "args": ["/path/to/your/project/ziwei_mcp_server.js"],
      "env": {
        "NODE_PATH": "/path/to/your/project/node_modules"
      }
    }
  }
}

Starting the server

Run the server from the repository root or the location of ziwei_mcp_server.js using the Node runtime.

npm start
# or
node ziwei_mcp_server.js

Usage within an MCP client

Configure your MCP client to load the ziwei MCP server configuration. Once connected, you can invoke the server’s tools through natural language prompts or direct tool calls supported by your client.

Notes on testing and validation

You can run tests if provided to ensure the server responds correctly to requests for the current time, Ziwei charts, and fortune data. Use the standard test script or commands described in the development setup to verify behavior.

Security and best practices

Limit access to the local server in production environments. Use secure channels for MCP interactions and avoid exposing internal endpoints publicly. Keep dependencies up to date and monitor for updates to the iztro library and Node.js runtime.

API overview and tools

The server exposes three main tools that you can call from your MCP client: get_current_time to retrieve detailed time information, calculate_ziwei to compute a complete Ziwei chart for a given birth date and time, and get_horoscope to fetch fortune horizon data for a specific date.

Available tools

get_current_time

Returns the current system time with detailed fields such as year, month, day, hour, minute, second, and timestamp.

calculate_ziwei

Calculates the Ziwei chart for a given birth date, time, and optional parameters like gender and lunar/solar type.

get_horoscope

Fetches fortune trajectory information such as major luck periods and annual luck based on the birth data and target date.