@anov/gis-skills-cli 0.0.0-stage → 0.3.3

package/lib/mcp-config.mjs

@@ -0,0 +1,273 @@
+// 各智能体的 MCP 配置读写。
+//
+// 只覆盖我们真正常用的几个，不做通用框架 —— 每多支持一个 agent 就多一份要维护的
+// 格式适配，收益却只落在少数人身上。
+//
+// 支持的 agent 与配置位置：
+//   claude-code  用户级 ~/.claude.json 的 mcpServers / 项目级 <cwd>/.mcp.json 的 mcpServers
+//   codex        用户级 ~/.codex/config.toml 的 [mcp_servers.<name>]
+//   cursor       项目级 <cwd>/.cursor/mcp.json / 用户级 ~/.cursor/mcp.json 的 mcpServers
+//   vscode       项目级 <cwd>/.vscode/mcp.json 的 servers（VS Code 用 servers，不是 mcpServers）
+//
+// 写入原则：读现有文件 → 只动自己那一个条目 → 原子写回。别人的条目一律不碰。
+
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+
+export const MCP_SERVER_NAME = "anov-gis";
+
+/** 我们往客户端注入的 env 变量白名单（只有这几个跟 MCP 运行有关）。 */
+const ENV_WHITELIST = [
+  "ANOV_GIS_MINIO_ENDPOINT",
+  "ANOV_GIS_MINIO_BUCKET",
+  "ANOV_GIS_MINIO_ACCESS_KEY",
+  "ANOV_GIS_MINIO_SECRET_KEY",
+  "ANOV_GIS_MINIO_REGION",
+  "ANOV_GIS_PUBLIC_STATIC_BASE",
+  "ANOV_GIS_PUBLIC_API_BASE",
+  "ANOV_GIS_ANOVCITY_BASE",
+  "ANOV_GIS_IP_ALLOWLIST",
+];
+
+/**
+ * 各 agent 的 MCP 配置位置。
+ *
+ * scope: project = 项目目录里的文件（可提交、团队共享）；global = 用户家目录（每人一份）。
+ * key:    该文件里承载 server 条目的顶层键。
+ */
+export function agentTargets(agent, scope, cwd = process.cwd()) {
+  const home = homedir();
+  switch (agent) {
+    case "claude-code":
+      return scope === "global"
+        ? [{ file: join(home, ".claude.json"), key: "mcpServers", label: "Claude Code（用户级）" }]
+        : [{ file: resolve(cwd, ".mcp.json"), key: "mcpServers", label: "Claude Code（项目级）" }];
+    case "codex":
+      return scope === "global"
+        ? [{ file: join(home, ".codex", "config.toml"), key: null, label: "Codex（用户级）" }]
+        : [];
+    case "cursor":
+      return scope === "global"
+        ? [{ file: join(home, ".cursor", "mcp.json"), key: "mcpServers", label: "Cursor（用户级）" }]
+        : [{ file: resolve(cwd, ".cursor", "mcp.json"), key: "mcpServers", label: "Cursor（项目级）" }];
+    case "vscode":
+      return scope === "global"
+        ? []
+        : [{ file: resolve(cwd, ".vscode", "mcp.json"), key: "servers", label: "VS Code（项目级）" }];
+    default:
+      return [];
+  }
+}
+
+export const SUPPORTED_AGENTS = ["claude-code", "codex", "cursor", "vscode"];
+
+/** 从当前进程环境里挑出要透传给 MCP 的变量。 */
+export function collectEnv(env = process.env) {
+  const out = {};
+  for (const key of ENV_WHITELIST) {
+    if (env[key]) out[key] = env[key];
+  }
+  return out;
+}
+
+/** 组装 MCP server 条目。 */
+export function buildServerConfig({ mode = "stdio", url, command, args, env }) {
+  if (mode === "http") {
+    if (!url) throw new Error("HTTP 模式需要 MCP 服务地址（--mcp-url）");
+    return { type: "http", url };
+  }
+  return {
+    type: "stdio",
+    command: command ?? "npx",
+    args: args ?? ["-y", "anov-gis-mcp", "--stdio"],
+    ...(env && Object.keys(env).length ? { env } : {}),
+  };
+}
+
+// ---------------------------------------------------------------- JSON 目标
+
+function readJson(file) {
+  if (!existsSync(file)) return {};
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch (err) {
+    throw new Error(`${file} 不是合法 JSON：${err.message}`);
+  }
+}
+
+/** 原子写：先写临时文件再 rename，避免写到一半把用户的配置弄坏。 */
+function writeAtomic(file, content) {
+  mkdirSync(dirname(file), { recursive: true });
+  const tmp = `${file}.anov-tmp`;
+  writeFileSync(tmp, content, "utf8");
+  renameSync(tmp, file);
+}
+
+export function readJsonServer(file, key, name) {
+  const json = readJson(file);
+  return json?.[key]?.[name];
+}
+
+export function writeJsonServer(file, key, name, config) {
+  const json = readJson(file);
+  const bucket = json[key] && typeof json[key] === "object" ? json[key] : {};
+  bucket[name] = config;
+  json[key] = bucket;
+  writeAtomic(file, `${JSON.stringify(json, null, 2)}\n`);
+  return file;
+}
+
+export function removeJsonServer(file, key, name) {
+  if (!existsSync(file)) return { file, removed: false };
+  const json = readJson(file);
+  if (!json?.[key]?.[name]) return { file, removed: false };
+  delete json[key][name];
+  writeAtomic(file, `${JSON.stringify(json, null, 2)}\n`);
+  return { file, removed: true };
+}
+
+// ---------------------------------------------------------------- TOML 目标（Codex）
+
+function tomlEscape(value) {
+  return String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+function tomlValue(value) {
+  if (typeof value === "boolean") return value ? "true" : "false";
+  if (typeof value === "number") return String(value);
+  if (Array.isArray(value)) return `[${value.map(tomlValue).join(", ")}]`;
+  return `"${tomlEscape(value)}"`;
+}
+
+/**
+ * Codex 的 config.toml 没有现成的解析器可用，这里只做「按表块定位与替换」：
+ * 找到 [mcp_servers.<name>] 到下一个 [ 之间的行，整块替换或删除。
+ *
+ * TOML 里追加到文件末尾是安全的 —— 新表从该行开始生效，不影响前面的表。
+ */
+export function readTomlServer(file, name) {
+  if (!existsSync(file)) return undefined;
+  const text = readFileSync(file, "utf8");
+  const main = findTomlBlock(text, name);
+  if (!main) return undefined;
+
+  const out = {};
+  for (const line of main.lines) {
+    const m = /^([A-Za-z0-9_-]+)\s*=\s*(.+)$/.exec(line.trim());
+    if (!m) continue;
+    out[m[1]] = parseTomlValue(m[2].trim());
+  }
+
+  // env 在紧跟主表的子表里 —— 表头本身不属于主表行，所以这里单独解析
+  const env = findTomlBlock(text, `${name}.env`);
+  if (env) {
+    const envObj = {};
+    for (const line of env.lines) {
+      const m = /^([A-Za-z0-9_-]+)\s*=\s*(.+)$/.exec(line.trim());
+      if (!m) continue;
+      envObj[m[1]] = parseTomlValue(m[2].trim());
+    }
+    if (Object.keys(envObj).length) out.env = envObj;
+  }
+  return out;
+}
+
+/** TOML 值的反向解析：够用即可（字符串 / 布尔 / 数字 / 字符串数组）。 */
+function parseTomlValue(raw) {
+  if (raw.startsWith("[")) {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  if (raw.startsWith('"') && raw.endsWith('"')) return raw.slice(1, -1);
+  if (raw === "true" || raw === "false") return raw === "true";
+  if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
+  return raw;
+}
+
+/**
+ * 定位 `[mcp_servers.<name>]` 表块（`<name>` 可带后缀，找 env 子表时传 `${name}.env`）。
+ */
+function findTomlBlock(text, name) {
+  const lines = text.split(/\r?\n/);
+  const header = `[mcp_servers.${name}]`;
+  const start = lines.findIndex((l) => l.trim() === header);
+  if (start === -1) return null;
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (/^\s*\[/.test(lines[i])) {
+      end = i;
+      break;
+    }
+  }
+  return { start, end, lines: lines.slice(start + 1, end) };
+}
+
+/**
+ * 主表 + 紧跟其后的 `.env` 子表算同一块 —— 否则替换主表时旧的 env 表会残留在文件里。
+ */
+function findServerBlock(text, name) {
+  const main = findTomlBlock(text, name);
+  if (!main) return null;
+  const env = findTomlBlock(text, `${name}.env`);
+  const end = env && env.start === main.end ? env.end : main.end;
+  const lines = text.split(/\r?\n/);
+  return { start: main.start, end, lines: lines.slice(main.start + 1, end) };
+}
+
+export function writeTomlServer(file, name, config) {
+  let text = existsSync(file) ? readFileSync(file, "utf8") : "";
+  const block = findServerBlock(text, name);
+
+  const body = [
+    `[mcp_servers.${name}]`,
+    ...Object.entries(config)
+      .filter(([k]) => k !== "env")
+      .map(([k, v]) => `${k} = ${tomlValue(v)}`),
+  ];
+  if (config.env && Object.keys(config.env).length) {
+    body.push("", `[mcp_servers.${name}.env]`);
+    for (const [k, v] of Object.entries(config.env)) body.push(`${k} = ${tomlValue(v)}`);
+  }
+
+  if (block) {
+    const lines = text.split(/\r?\n/);
+    lines.splice(block.start, block.end - block.start, ...body);
+    text = lines.join("\n");
+  } else {
+    text = `${text.replace(/\s*$/, "")}\n\n${body.join("\n")}\n`;
+  }
+  writeAtomic(file, text);
+  return file;
+}
+
+export function removeTomlServer(file, name) {
+  if (!existsSync(file)) return { file, removed: false };
+  const text = readFileSync(file, "utf8");
+  const block = findServerBlock(text, name);
+  if (!block) return { file, removed: false };
+  const lines = text.split(/\r?\n/);
+  lines.splice(block.start, block.end - block.start);
+  writeAtomic(file, lines.join("\n"));
+  return { file, removed: true };
+}
+
+// ---------------------------------------------------------------- 统一入口
+
+export function readServer(target, name) {
+  if (!target.key) return readTomlServer(target.file, name);
+  return readJsonServer(target.file, target.key, name);
+}
+
+export function writeServer(target, name, config) {
+  if (!target.key) return writeTomlServer(target.file, name, config);
+  return writeJsonServer(target.file, target.key, name, config);
+}
+
+export function removeServer(target, name) {
+  if (!target.key) return removeTomlServer(target.file, name);
+  return removeJsonServer(target.file, target.key, name);
+}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@anov/gis-skills-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.3",
+  "description": "12 个 @anov/gis (Cesium 1.143) 领域 skill + 15 个 Cesium 原生 skill，外加 anov-gis-mcp 的接入配置。一条命令装到 Claude Code / Codex / Cursor 等智能体。",
+  "type": "module",
+  "license": "ISC AND Apache-2.0",
+  "author": "",
+  "homepage": "",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "files": [
+    "skills",
+    "vendor",
+    "lib",
+    "README.md",
+    "INSTALL.md",
+    "RELEASING.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "bin": {
+    "anov-gis-skills": "bin/anov-gis-skills.mjs",
+    "anov-gis-skills-cli": "bin/anov-gis-skills.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "anov-gis",
+    "cesium",
+    "gis",
+    "3dtiles",
+    "agent-skills",
+    "claude-code",
+    "codex",
+    "cursor"
+  ],
+  "scripts": {
+    "release": "node scripts/release.cjs",
+    "prepublishOnly": "node scripts/bump.mjs --check && node scripts/check-structure.mjs",
+    "pack:check": "node scripts/build-npm.mjs"
+  }
+}