BaZi True Solar Time MCP logo

BaZi True Solar Time MCP

Converts local civil time into corrected true solar time using an IANA timezone and longitude.

Install BaZi True Solar Time MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "bazi-true-solar-time-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bazi-true-solar-time-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y bazi-true-solar-time-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

BaZi True Solar Time MCP is a deterministic, read-only MCP server for converting local civil time into true solar time. Its single tool accepts a date, time, IANA timezone, longitude, and optional latitude, then reports UTC, correction components, date shifts, warnings, and confidence. Calculations run locally without geocoding, external APIs, storage, or address lookup. Use it for reproducible BaZi, Four Pillars, calendrical, astronomy, and other time-normalization workflows.

Use cases

  • Normalize birth times for BaZi or Four Pillars workflows
  • Convert civil timestamps using trusted longitude and timezone data
  • Inspect daylight-saving, longitude, and equation-of-time corrections
  • Build reproducible calendrical or astronomy calculations
  • Check date rollover during true solar time conversion

Key features

  • Deterministic true solar time conversion
  • Single read-only MCP tool
  • IANA timezone and longitude support
  • Separate correction components and date shifts
  • Local calculation without external APIs
  • Warnings, confidence, and engine version in results

Tools1

What BaZi True Solar Time MCP lets your agent do. Expand a tool for its parameters.

Self-reported~8 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10h ago via OSV.dev · bazi-true-solar-time-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit1d agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed1Callable tools this server registers over MCP.

How BaZi True Solar Time MCP works

What BaZi True Solar Time MCP does

BaZi True Solar Time MCP normalizes a local civil timestamp into corrected true solar time. It is intended for workflows where the relationship between clock time, geographic longitude, time-zone rules, daylight-saving changes, and the equation of time needs to be visible and reproducible.

The server focuses on calculation rather than interpretation. It does not create BaZi charts, generate fortune-telling text, prove astrological claims, or provide predictions. It also does not look up addresses, retain birth data, or call a language model.

How it works

The server exposes one read-only MCP tool: calculate_true_solar_time. The tool takes a local date in YYYY-MM-DD format, a local time in HH:mm format, an IANA timezone identifier, and a longitude in decimal degrees. Longitude must be between -180 and 180, with east represented by positive values.

Latitude is optional and may be supplied for traceability. It is validated within -90 to 90 degrees but does not drive the correction. The calculation instead uses longitude, the applicable time-zone offset, and the equation of time.

Results identify the original civil time and corresponding UTC instant, then show the corrected local apparent solar time. The response also separates the longitude, equation-of-time, and daylight-saving corrections, reports any date rollover, and includes warnings, a confidence label, and a versioned engine identifier.

Setup and configuration

The package can be launched directly through npm:

Terminal
npx -y bazi-true-solar-time-mcp

For a source checkout, install dependencies, build the project, and start the generated server:

bash
git clone https://github.com/cdaily1995-create/true-solar-time-mcp.git
cd true-solar-time-mcp
pnpm install
pnpm build
node dist/server.js

A stdio MCP client can start it with the following configuration:

config.json
{
  "mcpServers": {
    "true-solar-time": {
      "command": "npx",
      "args": ["-y", "bazi-true-solar-time-mcp"]
    }
  }
}

The server requires no API key, account, database, analytics service, or external API. Coordinates and time-zone identifiers are processed by the local server process.

Tools and capabilities

calculate_true_solar_time supports these inputs:

  • date: required local civil date in YYYY-MM-DD format.
  • time: required local civil time in HH:mm format.
  • timezone: required IANA identifier such as Asia/Shanghai or America/Los_Angeles.
  • longitude: required decimal degrees from -180 to 180, with east positive.
  • latitude: optional decimal degrees from -90 to 90, retained for traceability.

The output provides the UTC instant, corrected true solar time, each correction component, date shifts, warnings, confidence, and the calculation engine version. This breakdown makes it possible to inspect how a civil timestamp was transformed instead of receiving only a normalized time.

Limitations and notes

Accurate results depend on supplying a trusted longitude and the correct IANA timezone. The server does not infer coordinates from an address or resolve missing location data. Latitude is informational for traceability rather than a factor in the correction.

This is a time-conversion utility for calendrical, astronomy, BaZi, Four Pillars, and related workflows. It is not a prediction service or a validation of any astrological interpretation.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about BaZi True Solar Time MCP

BaZi True Solar Time MCP is an MCP server that converts local civil time into true solar time for BaZi, calendrical, astronomy, and time-normalization workflows. Its main tool, calculate_true_solar_time, accepts a date, time, IANA timezone, longitude, and optional latitude, returning UTC, corrections, date shifts, warnings, and confidence.

Install it by running `npx -y bazi-true-solar-time-mcp`, or clone the repository, run `pnpm install` and `pnpm build`, then start `node dist/server.js`. MCP clients can launch the npm package through a stdio configuration using `npx` and the package name.

Yes, BaZi True Solar Time MCP works with Cursor through its standard stdio MCP configuration. Configure Cursor to run `npx` with `-y bazi-true-solar-time-mcp` as the argument, then call the server's read-only calculation tool.

The tool requires a local `date`, `time`, IANA `timezone`, and east-positive decimal `longitude`. `latitude` is optional and retained for traceability. Dates use `YYYY-MM-DD`, times use `HH:mm`, longitude ranges from -180 to 180, and latitude ranges from -90 to 90.

No, BaZi True Solar Time MCP calculates locally and does not perform address lookup or require an external API. You must provide the timezone and coordinates yourself; the server does not infer longitude or latitude from an address.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBaZi True Solar Time MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/bazi-true-solar-time-mcp?style=directory)](https://allmcps.com/mcp/bazi-true-solar-time-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/bazi-true-solar-time-mcp"><img src="https://allmcps.com/api/badge/bazi-true-solar-time-mcp?style=directory" alt="BaZi True Solar Time MCP on AllMCPs" /></a>