Iz Tro

紫微斗数排盘服务

javascript

9

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks 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": {
    "smogievogie-ziwei_iztro-mcpserver": {
      "command": "npx",
      "args": [
        "ziwei_iztro-mcpserver"
      ],
      "env": {
        "AMAP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run the iztro MCP Server to generate Ziwei Doushu star charts, perform geographic lookups, and convert times to true solar time. It integrates with the MCP ecosystem so clients can request astrology data using standard MCP patterns while leveraging geocoding and precise solar time calculations.

How to use

You will run the MCP server as a local service or integrate it into your MCP client configuration. When integrated, your client can request star charts, geocode locations, and convert times to apparent solar time using the server’s endpoints. The server exposes three core capabilities: geocoding a location, converting Beijing time to apparent solar time, and generating a Ziwei star chart based on birth data and location.

To integrate with your MCP client, add an MCP server entry that points to the server’s stdio configuration. This enables you to launch the server as a local process and communicate through the MCP protocol.

How to install

Prerequisites you need before installing: Node.js version 16.0.0 or newer, and a package manager such as npm or yarn.

Install the MCP server globally (optional but recommended)

npm install -g ziwei_iztro-mcpserver

Or install locally in your project directory

npm i ziwei_iztro-mcpserver

Prepare configuration and API keys for the geocoding service. You need an API key from the map provider for geocoding. Create a configuration file or use environment variables as described below.

Configuring access and runtime

Important: provide your map API key before starting the server. You can supply it via an environment file or a configuration file.

Option A: Environment variables (recommended)

# Copy example env file
cp .env.example .env

# Edit .env and add your AMAP_API_KEY
# Example entry:
AMAP_API_KEY=your_actual_api_key_here

Option B: Configuration file

# Copy example configuration file
cp iztro-mcp-config.example.json iztro-mcp-config.json

# Edit iztro-mcp-config.json and insert your API key where required

Option C: Automatic setup (interactive) creates configuration files for you

npm run setup

Available tools

geocode_location

Converts a location name into precise geographic coordinates and returns the longitude, latitude, and formatted address.

convert_to_apparent_solar_time

Converts Beijing time to apparent solar time based on a given location, returning the solar time and supporting timezone decisions.

generate_astrolabe

Generates a Ziwei Doushu star chart using birth data and optionally location for true solar time conversion; supports multiple output languages and calendar types.