True Solar Time MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@True Solar Time MCP Server what's the true solar time for 14:30 on 1990-05-20 in Asia/Shanghai, longitude 104.0668?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
True Solar Time MCP Server
An MCP server for deterministic true solar time conversion from a local civil time, IANA timezone, and longitude.
Built for reproducible calendrical, astronomy, BaZi, and Four Pillars workflows. The server is intentionally narrow: it does not geocode an address, call a language model, persist birth data, or generate fortune-telling text.
Why this is useful
No address lookup. Pass the timezone and coordinates you already trust; there is no hidden geocoding request.
Transparent correction. The result separates longitude correction, equation of time, DST correction, UTC, and date rollover.
MCP-native. One read-only tool works with Claude Desktop, Cursor, Codex, and other MCP clients.
Privacy-friendly. Calculation is local to the process running the server.
Related MCP server: temporal-mcp-server
Tool
calculate_true_solar_time
Input:
{
"date": "1990-05-20",
"time": "14:30",
"timezone": "Asia/Shanghai",
"longitude": 104.0668,
"latitude": 30.5728
}longitude is required and uses decimal degrees with east positive. latitude is optional and is retained for traceability; the correction is driven by longitude, the time-zone offset, and the equation of time.
The result includes the civil time, UTC instant, corrected true solar time, longitude correction, equation-of-time correction, DST correction, date shifts, warnings, and a confidence label.
Quick start
git clone https://github.com/cdaily1995-create/true-solar-time-mcp.git
cd true-solar-time-mcp
pnpm install
pnpm build
node dist/server.jsMCP client configuration:
{
"mcpServers": {
"true-solar-time": {
"command": "node",
"args": ["/absolute/path/to/true-solar-time-mcp/dist/server.js"]
}
}
}Example
calculate_true_solar_time {
"date": "2002-07-07",
"time": "05:05",
"timezone": "America/Los_Angeles",
"longitude": -118.2437,
"latitude": 34.0522
}The response includes a versioned engineVersion, the UTC instant, the corrected local apparent solar time, each correction component, warnings, and confidence.
Input contract
Field | Required | Description |
| yes | Local civil date in |
| yes | Local civil time in |
| yes | IANA identifier such as |
| yes | Decimal degrees, east positive, from |
| no | Decimal degrees, from |
Links
BaZi Calculator — the public calculator project using this kind of time normalization.
Four Pillars of Destiny guide — background on the chart context.
What is a BaZi chart? — plain-language chart explanation.
Four Pillars MCP Server — the companion deterministic chart calculator.
MCP specification — protocol documentation.
MCP TypeScript server SDK — server SDK used by this project.
Search-friendly description
This project is a true solar time calculator for birth-time normalization. It explains how civil time, longitude, historical time zones, daylight-saving offsets, and the equation of time affect local apparent solar time. It is useful for BaZi, Four Pillars, traditional calendar, astronomy, and time-normalization workflows where reproducible numeric output is more important than interpretation.
Privacy and scope
The server accepts coordinates and time-zone identifiers only. It has no address search, analytics, database, account, payment, or external API requirement. Results are calculated locally by the process running the MCP server.
This is a time conversion utility, not scientific proof of any astrological interpretation and not a prediction service.
License
MIT
Available Tools
1 toolcalculate_true_solar_timeARead-onlyIdempotent
Convert a local civil birth time to local apparent true solar time using the supplied IANA timezone and longitude. Returns UTC, longitude correction, equation of time, DST correction, date-shift warnings, and confidence. No address lookup is performed.
Inputs: date (required), time (required), timezone (required), longitude (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusing it with another. Its purpose—converting civil time to true solar time—is stated unambiguously in the description.
The single name, calculate_true_solar_time, follows a clear snake_case verb_noun pattern and precisely describes the action and target. No competing conventions exist to conflict with it.
A one-tool surface is thin even for a narrowly scoped calculation server; useful neighbors like inverse conversion or batch/multi-date processing are absent. The tool itself is non-trivial and earns its place, but the set feels minimal.
The stated forward conversion (civil time → true solar time) appears fully served, including UTC, equation of time, DST and confidence outputs. However, there is no inverse conversion (true solar → civil), no batch handling, and no related solar computations, leaving notable gaps for agents working the domain both ways.
Maintenance
Related MCP Connectors
Convert times between IANA zones and detect skipped or ambiguous DST local times.
Current time by timezone, astronomy events, and moon phases
Timezone MCP — wraps timeapi.io (free, no auth)
Unofficial Sunrise-Sunset MCP — wraps the sunrisesunset.io API (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConverts civil time to true solar time and audits whether civil and solar times cross Chinese 时辰 boundaries, for time-sensitive divination workflows.54 npmMIT
- AlicenseAqualityBmaintenanceMCP server for time, timezone, and duration operations. Enables getting current time in any timezone, converting timestamps between timezones, adding/subtracting ISO-8601 durations, and computing time between two timestamps.5231 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to convert recorded birth times into true solar time for BaZi / Four Pillars charting, applying historical DST, longitude, and equation-of-time corrections. It also detects nonexistent local times and warns when a corrected time is near an hour-branch boundary.54 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to convert datetimes between IANA timezones with DST-aware UTC offsets and ISO 8601 I/O, with pay-per-call x402 micropayments via MCP.MIT