@ikeytz/maps-mcp 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.0.4
+
+- Legal tools: get_legal, Urheberrecht/Copyright/Impressum (maps text), AGB/Nutzung/Datenschutz/Widerruf (www URLs).
+- CLI flags like www: `list` prints global flags, `list --global`, per-tool `-h` with args + `--show-mcp-command`.
+
 ## 1.0.3
 
 - More maps-only commands: slugs, PLZ index, hub, embed, geo_api, Lage, Geschichte, Distanz, URL-resolve, Google-Maps-Paste.

package/README.md

@@ -38,7 +38,7 @@ Install (Mac/Linux/Windows):
 
 ```bash
 npm i -g @ikeytz/maps-mcp
-ikeytz-maps-mcp --version   # z. B. 1.0.3
+ikeytz-maps-mcp --version   # z. B. 1.0.4
 ikeytz-maps-mcp update      # später: npm i -g @ikeytz/maps-mcp@latest
 ```
 
@@ -98,6 +98,7 @@ ikeytz-maps-mcp                 # MCP stdio proxy (any MCP host) — keine Args
 ikeytz-maps-mcp help            # Usage + Flags (offline)
 ikeytz-maps-mcp update [ver]    # npm i -g @ikeytz/maps-mcp@latest
 ikeytz-maps-mcp list            # Tools (offline) + global CLI flags
+ikeytz-maps-mcp list --global   # nur globale Flags (wie ikeytz-mcp)
 ikeytz-maps-mcp describe NAME   # = ikeytz-maps-mcp NAME -h
 ikeytz-maps-mcp call NAME …     # oder: ikeytz-maps-mcp NAME …
 ```
@@ -112,6 +113,7 @@ ikeytz-maps-mcp call NAME …     # oder: ikeytz-maps-mcp NAME …
 | `--show-mcp-command` | curl 1a/1b/2 only |
 | `--raw` | JSON structuredContent |
 | `--json '{…}'` | Roh-Arguments |
+| `list --global` | nur globale Flags (offline) |
 
 ## Geo-Tools — Payload (vom Server, CLI spiegelt 1:1)
 
@@ -156,6 +158,14 @@ Volltext Geo: `ikeytz-maps-mcp get_discovery --which llms-orte-geo`
 | `distance_to_office` | `--slug` · `--lat` · `--lng` · `--icbm` |
 | `resolve_maps_url` | `--url` |
 | `find_by_google_maps` | `--q` (Koordinaten-Paste) |
+| `get_legal` | `--doc*` urheberrecht\|copyright\|impressum\|agb\|nutzungsbedingungen\|datenschutz\|widerruf |
+| `get_urheberrecht` | — (maps `/llms-urheberrecht.txt`) |
+| `get_copyright` | — |
+| `get_impressum` | — |
+| `get_agb` | — (www-URL) |
+| `get_nutzungsbedingungen` | — (www-URL) |
+| `get_datenschutz` | — (www-URL) |
+| `get_widerruf` | — (www-URL) |
 
 Präfix immer `ikeytz-maps-mcp` (z. B. `ikeytz-maps-mcp find_by_plz --plz=71638`).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikeytz/maps-mcp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "mcpName": "com.ikeytz/maps",
   "description": "Official terminal CLI and MCP stdio proxy for maps.ikeytz.com. Not @ikeytz/mcp.",
   "type": "module",

package/src/cli.js

@@ -15,9 +15,70 @@ const TOOL_FLAGS = [
   "lat",
   "lng",
   "radius_km",
+  "doc",
 ];
 const NUMBER_FLAGS = new Set(["offset", "limit", "lat", "lng", "radius_km"]);
 
+function globalCliFlagsLines() {
+  return [
+    "Global CLI flags (every tool — not sent to MCP)",
+    "  -h, --help, -help   per-tool help (offline)",
+    "  --raw               JSON structuredContent",
+    "  --show-mcp-command  curl 1a/1b/2 only — no MCP call (alias: --show-mcp-befehl)",
+    "  --json '{…}'        raw MCP arguments",
+    "",
+    "Default tool output   payload only (no ok/tool/meta envelope)",
+    "  --name=value   --name value",
+  ];
+}
+
+function exampleForTool(name) {
+  const examples = {
+    get_service_area: "ikeytz-maps-mcp get_service_area --slug=pattonville",
+    get_discovery: "ikeytz-maps-mcp get_discovery --which=llms-urheberrecht",
+    find_by_plz: "ikeytz-maps-mcp find_by_plz --plz=71638",
+    get_legal: "ikeytz-maps-mcp get_legal --doc=urheberrecht",
+    get_urheberrecht: "ikeytz-maps-mcp get_urheberrecht",
+    get_agb: "ikeytz-maps-mcp get_agb",
+    get_nutzungsbedingungen: "ikeytz-maps-mcp get_nutzungsbedingungen",
+    get_lage: "ikeytz-maps-mcp get_lage --slug=pattonville",
+  };
+  return examples[name] || `ikeytz-maps-mcp ${name}`;
+}
+
+function formatToolHelp(tool) {
+  const schema = tool.inputSchema || { type: "object", properties: {} };
+  const props = schema.properties || {};
+  const req = new Set(schema.required || []);
+  const lines = [tool.name, tool.description || "", "", "Arguments"];
+  const keys = Object.keys(props);
+  if (!keys.length) {
+    lines.push("  (none)");
+  } else {
+    for (const key of keys) {
+      const p = props[key] || {};
+      const type = p.enum ? p.enum.join("|") : p.type || "any";
+      const star = req.has(key) ? "*" : " ";
+      lines.push(`  ${star} --${key.padEnd(16)} ${type}`);
+    }
+    if (req.size) {
+      lines.push("");
+      lines.push("  * required");
+    }
+  }
+  lines.push("");
+  lines.push("CLI flags (not sent to MCP)");
+  lines.push("  -h, --help, -help  this help (offline, no MCP call)");
+  lines.push("  --raw              JSON structuredContent");
+  lines.push("  --show-mcp-command   curl 1a/1b/2 only — no MCP call (alias: --show-mcp-befehl)");
+  lines.push("");
+  lines.push("Examples");
+  lines.push(`  ${exampleForTool(tool.name)}`);
+  lines.push(`  ikeytz-maps-mcp ${tool.name} -h`);
+  lines.push(`  ikeytz-maps-mcp ${tool.name} --show-mcp-command`);
+  return `${lines.join("\n")}\n`;
+}
+
 const HELP = `ikeytz-maps-mcp ${packageVersion()}
 Remote: ${mapsMcpUrl()}
 Nur maps. Nicht @ikeytz/mcp / www.
@@ -25,16 +86,19 @@ Nur maps. Nicht @ikeytz/mcp / www.
 Ohne Args          stdio-Proxy (Cursor/Claude)
 help | --help      diese Hilfe
 --version          Version
-update             npm i -g @ikeytz/maps-mcp@latest
-list               ${toolNames().length} Tools (offline)
-describe <tool>    Schema (offline)
+update [ver]       npm i -g @ikeytz/maps-mcp@latest
+list               ${toolNames().length} Tools (offline) + global CLI flags
+list --global      nur globale CLI-Flags (offline)
+describe <tool>    Args + Flags + Beispiele (offline)
 call <tool> …      wie <tool> …
 <tool>             Payload von maps /mcp
-<tool> -h          Args (offline)
+<tool> -h          Args + CLI-Flags (offline)
 <tool> --show-mcp-command | --show-mcp-befehl
-<tool> --raw       volles JSON-RPC
+<tool> --raw       JSON structuredContent
 <tool> --json '{…}'
 
+${globalCliFlagsLines().join("\n")}
+
 Tools:
 ${toolNames()
   .map((n) => `  ${n}`)
@@ -47,7 +111,8 @@ function parseArgv(argv) {
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--raw") flags.raw = true;
-    else if (a === "-h" || a === "--help") flags.help = true;
+    else if (a === "--global") flags.global = true;
+    else if (a === "-h" || a === "--help" || a === "-help") flags.help = true;
     else if (a === "--version") flags.version = true;
     else if (a === "--show-mcp-command" || a === "--show-mcp-befehl") flags.showMcp = true;
     else if (a === "--json") flags.json = argv[++i] || "";
@@ -192,14 +257,19 @@ export async function main(argv) {
     return;
   }
   if (cmd === "update") {
+    const ver = positionals[1] ? String(positionals[1]).replace(/^@/, "") : "latest";
     await new Promise((resolve, reject) => {
-      const child = spawn("npm", ["i", "-g", "@ikeytz/maps-mcp@latest"], { stdio: "inherit" });
+      const child = spawn("npm", ["i", "-g", `@ikeytz/maps-mcp@${ver}`], { stdio: "inherit" });
       child.on("exit", (code) => (code === 0 ? resolve() : reject(new Error(`npm exit ${code}`))));
     });
     return;
   }
   if (cmd === "list") {
-    process.stdout.write(`${toolNames().join("\n")}\n`);
+    if (flags.global) {
+      process.stdout.write(`${globalCliFlagsLines().join("\n")}\n`);
+      return;
+    }
+    process.stdout.write(`${toolNames().join("\n")}\n\n${globalCliFlagsLines().join("\n")}\n`);
     return;
   }
   if (cmd === "describe") {
@@ -210,7 +280,7 @@ export async function main(argv) {
       process.exitCode = 1;
       return;
     }
-    process.stdout.write(`${JSON.stringify(tool, null, 2)}\n`);
+    process.stdout.write(formatToolHelp(tool));
     return;
   }
 
@@ -223,7 +293,7 @@ export async function main(argv) {
     return;
   }
   if (flags.help) {
-    process.stdout.write(`${tool.name}\n${tool.description}\n${JSON.stringify(tool.inputSchema, null, 2)}\n`);
+    process.stdout.write(formatToolHelp(tool));
     return;
   }
   const args = argsFromFlags(flags);

package/src/tools-catalog.json

@@ -432,6 +432,113 @@
           }
         }
       }
+    },
+    {
+      "name": "get_legal",
+      "description": "Legal: urheberrecht|copyright|impressum (maps-Text) oder agb|nutzungsbedingungen|datenschutz|widerruf (www-URL).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "doc": {
+            "type": "string",
+            "enum": [
+              "urheberrecht",
+              "copyright",
+              "impressum",
+              "agb",
+              "nutzungsbedingungen",
+              "datenschutz",
+              "widerruf"
+            ]
+          },
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "doc"
+        ]
+      }
+    },
+    {
+      "name": "get_urheberrecht",
+      "description": "Karten-Urheberrecht: maps /llms-urheberrecht.txt (HTML auf www).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_copyright",
+      "description": "Karten-Copyright EN: maps /llms-copyright.txt.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_impressum",
+      "description": "Impressum/Kontakt-Text: maps /llms-impressum-kontakt.txt.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_agb",
+      "description": "AGB: Link www.ikeytz.com/agb (HTML bleibt www, kein Preise-Corpus).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_nutzungsbedingungen",
+      "description": "Nutzungsbedingungen: Link www (HTML bleibt www).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_datenschutz",
+      "description": "Datenschutz: Link www (HTML bleibt www).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_widerruf",
+      "description": "Widerruf: Link www (HTML bleibt www).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
     }
   ]
 }