mclocks-datetime-util 0.0.3 → 0.0.5

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.5",
   "description": "MCP server for datetime and timezone conversion, powered by mclocks config",
   "type": "module",
   "bin": {
@@ -24,6 +24,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "cdate": "0.0.7",
+    "jsonc-parser": "^3.3.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/server.js

@@ -4,6 +4,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { cdate } from "cdate";
+import { parse as parseJsonc } from "jsonc-parser";
 import { readFileSync } from "fs";
 import { join } from "path";
 
@@ -76,7 +77,12 @@ function loadMclocksConfig() {
   }
   try {
     const raw = readFileSync(configPath, "utf-8");
-    return JSON.parse(raw);
+    const errors = [];
+    const parsed = parseJsonc(raw, errors, { allowTrailingComma: true });
+    if (errors.length > 0 || parsed === null || typeof parsed !== "object") {
+      return null;
+    }
+    return parsed;
   } catch {
     return null;
   }
@@ -125,6 +131,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 +273,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.",