mclocks-datetime-util 0.0.3 → 0.0.4

package/README.md

@@ -9,6 +9,7 @@ An MCP (Model Context Protocol) server that gives AI assistants the ability to a
 | Tool | Description |
 |------|-------------|
 | **`current-time`** | Get the current time in your configured timezones |
+| **`local-time`** | Get the current local time in the user's timezone (from `convtz` config or system default). Useful when other MCP tools or prompts need the user's local date/time |
 | **`convert-time`** | Convert a datetime string or epoch timestamp to multiple timezones |
 | **`next-weekday`** | Find the date of the next occurrence of a given weekday |
 | **`date-to-weekday`** | Get the day of the week for a given date |
@@ -54,7 +55,7 @@ If you use the [mclocks](https://github.com/bayashi/mclocks) desktop app, the MC
 
 - **`clocks`** — Timezones from your clocks become default conversion targets
 - **`convtz`** — Default source timezone for datetime strings without timezone info
-- **`usetz`** — Controls strict timezone conversion mode
+- **`usetz`** — Enables strict timezone conversion for historically accurate UTC offsets (e.g. JST was +09:18 before 1888)
 - **`locale`** — Language for weekday names (e.g. `ja`, `pt`, `de`)
 
 Config file locations:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mclocks-datetime-util",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "MCP server for datetime and timezone conversion, powered by mclocks config",
   "type": "module",
   "bin": {

package/server.js

@@ -125,6 +125,8 @@ function convertToTimezone(cdt, src, tz, usetz) {
   try {
     let result;
     if (usetz) {
+      // Use strict timezone conversion for historically accurate UTC offsets.
+      // For example, before 1888/1/1 00:00:00 in JST, its utcOffset is 09:18.
       result = cdt(src).tz(tz).text();
     } else {
       const offset = cdt().tz(tz).utcOffset();
@@ -265,6 +267,23 @@ server.tool(
   }
 );
 
+server.tool(
+  "local-time",
+  "Get the current local time in the user's timezone (from convtz config or system default). Use this when other MCP tools or prompts need the user's local date/time.",
+  {},
+  async () => {
+    const tz = configConvTZ || Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const source = configConvTZ ? "config (convtz)" : "system";
+    const now = new Date();
+    const cdt = cdate().cdateFn();
+    const offset = cdt().tz(tz).utcOffset();
+    const result = cdt(now).utcOffset(offset).text();
+    return {
+      content: [{ type: "text", text: `${result} in ${tz} (source: ${source})` }],
+    };
+  }
+);
+
 server.tool(
   "next-weekday",
   "Find the date of the next occurrence of a given weekday from today.",