@leeguoo/yapi-mcp 0.3.10 → 0.3.12

package/README.md

@@ -62,7 +62,19 @@ Yapi Auto MCP Server 是一个基于 [Model Context Protocol](https://modelconte
 
 ### Skill 一键安装与 CLI
 
-一条命令把 Skill 安装到 Codex / Claude Code，并写入 `~/.yapi/config.toml`（缺省会提示输入）：
+一条命令把 Skill 安装到 Codex / Claude Code / Cursor，并写入 `~/.yapi/config.toml`（缺省会提示输入）：
+
+```bash
+# 推荐：全局安装后使用 yapi 命令
+npm install -g @leeguoo/yapi-mcp
+
+yapi install-skill \
+  --yapi-base-url=https://your-yapi-domain.com \
+  --yapi-email=your_email@example.com \
+  --yapi-password=your_password
+```
+
+也可以用 npx 临时运行（不全局安装）：
 
 ```bash
 npx -y @leeguoo/yapi-mcp install-skill \
@@ -71,15 +83,35 @@ npx -y @leeguoo/yapi-mcp install-skill \
   --yapi-password=your_password
 ```
 
-CLI 使用示例（走同一份 `~/.yapi/config.toml`）：
+Skill 安装目录：
+- Codex: `~/.codex/skills/yapi/`
+- Claude Code: `~/.claude/skills/yapi/`
+- Cursor: `~/.cursor/skills/yapi/`
+
+Skill 模板来源：`packages/yapi-mcp/skill-template/SKILL.md`（发布后从包内复制到技能目录）。
+
+### CLI 使用
+
+推荐全局安装后直接使用 `yapi` 命令（走同一份 `~/.yapi/config.toml`）：
 
 ```bash
-npx -y @leeguoo/yapi-mcp yapi -V
-npx -y @leeguoo/yapi-mcp yapi -h
-npx -y @leeguoo/yapi-mcp yapi login
-npx -y @leeguoo/yapi-mcp yapi whoami
-npx -y @leeguoo/yapi-mcp yapi search --q keyword
-npx -y @leeguoo/yapi-mcp yapi --path /api/interface/get --query id=123
+# 检查版本
+yapi --version
+
+# 查看帮助
+yapi -h
+
+# 登录（交互式，会提示输入 base_url/email/password）
+yapi login
+
+# 检查当前登录用户
+yapi whoami
+
+# 搜索接口
+yapi search --q keyword
+
+# 获取接口详情
+yapi --path /api/interface/get --query id=123
 ```
 
 全局模式下可先执行 `yapi login` 缓存登录态（`~/.yapi-mcp/auth-*.json`），权限失效会自动重新登录。
@@ -87,15 +119,15 @@ npx -y @leeguoo/yapi-mcp yapi --path /api/interface/get --query id=123
 Markdown 同步到 YApi（支持 Mermaid 预渲染，需 `pandoc` + `mmdc`）：
 
 ```bash
-npx -y @leeguoo/yapi-mcp yapi docs-sync bind add \
+yapi docs-sync bind add \
   --name projectA \
   --dir docs/release-notes \
   --project-id 267 \
   --catid 3667
 
-npx -y @leeguoo/yapi-mcp yapi docs-sync --binding projectA
+yapi docs-sync --binding projectA
 # 或同步 .yapi/docs-sync.json 内的所有绑定
-npx -y @leeguoo/yapi-mcp yapi docs-sync
+yapi docs-sync
 ```
 
 说明：

package/dist/skill/install.js

@@ -12,518 +12,48 @@ const yargs_1 = __importDefault(require("yargs"));
 const SKILL_NAME = "yapi";
 const PLACEHOLDER_EMAIL = "YOUR_EMAIL";
 const PLACEHOLDER_PASSWORD = "YOUR_PASSWORD";
-const SKILL_MD = [
-    "---",
-    "name: yapi",
-    'description: Query and sync YApi interface documentation. Use when user mentions \"yapi 接口文档\", YAPI docs, asks for request/response details, or needs docs sync.',
-    "---",
-    "",
-    "# YApi interface docs",
-    "",
-    "## Workflow",
-    "1. Load config from `~/.yapi/config.toml` (preferred) or `config.toml` in this skill directory (base_url, auth_mode, email/password or token, optional project_id).",
-    "2. Identify the target interface by id or keyword; ask for project/category ids if needed.",
-    "3. Call YApi endpoints with `scripts/yapi_request.js` to fetch raw JSON.",
-    "4. Summarize method, path, headers, query/body schema, response schema, and examples.",
-    "",
-    "## CLI",
-    "- Install & run: `npx -y @leeguoo/yapi-mcp yapi -h` (or install globally and use `yapi`).",
-    "- Use the same config as the skill: `~/.yapi/config.toml`.",
-    "",
-    "## Docs sync",
-    "- Bind local docs to YApi category with `yapi docs-sync bind add --name <binding> --dir <path> --project-id <id> --catid <id>` (stored in `.yapi/docs-sync.json`).",
-    "- Sync with `yapi docs-sync --binding <binding>` or run all bindings with `yapi docs-sync`.",
-    "- Default syncs only changed files; use `--force` to sync everything.",
-    "- Mermaid rendering depends on `mmdc` (auto-installed if possible; failures do not block sync).",
-    "- For full Markdown render, install `pandoc` (manual install required).",
-    "- Extra mappings (generated after docs-sync run in binding mode):",
-    "  - `.yapi/docs-sync.links.json`: local docs to YApi doc URLs.",
-    "  - `.yapi/docs-sync.projects.json`: cached project metadata/envs.",
-    "  - `.yapi/docs-sync.deployments.json`: local docs to deployed URLs.",
-    "",
-    "## Interface creation tips",
-    "- When adding interfaces, always set `req_body_type` (use `json` if unsure) and provide `res_body` (prefer JSON Schema). Empty values can make `/api/interface/add` fail.",
-    "- Keep request/response structures in `req_*` / `res_body` instead of stuffing them into `desc` or `markdown`.",
-    "",
-    "## Script",
-    "- Basic: `node <skill-dir>/scripts/yapi_request.js --path /api/interface/get --query id=123`",
-    "- The script reads `~/.yapi/config.toml` first, then `<skill-dir>/config.toml`; pass `--config` for a custom path.",
-    "- Use `--base-url`, `--token`, `--project-id` to override config.",
-    "- For `auth_mode=global`, the script logs in via `/api/user/login` and uses the returned cookie automatically.",
-    '- For POST: `--method POST --data \'{"key":"value"}\'`',
-    "- If your instance differs, pass a full URL with `--url`.",
-    "",
-].join("\n");
-const REQUEST_SCRIPT = [
-    "#!/usr/bin/env node",
-    '"use strict";',
-    "",
-    'const fs = require("fs");',
-    'const os = require("os");',
-    'const path = require("path");',
-    'const readline = require("readline");',
-    "",
-    "function parseKeyValue(raw) {",
-    '  if (!raw || !raw.includes("=")) throw new Error("expected key=value");',
-    '  const idx = raw.indexOf("=");',
-    "  return [raw.slice(0, idx), raw.slice(idx + 1)];",
-    "}",
-    "",
-    "function parseHeader(raw) {",
-    '  if (!raw || !raw.includes(":")) throw new Error("expected Header:Value");',
-    '  const idx = raw.indexOf(":");',
-    "  return [raw.slice(0, idx).trim(), raw.slice(idx + 1).trim()];",
-    "}",
-    "",
-    "function joinUrl(baseUrl, endpoint) {",
-    "  if (!baseUrl) return endpoint;",
-    '  if (baseUrl.endsWith("/") && endpoint.startsWith("/")) return baseUrl.slice(0, -1) + endpoint;',
-    '  if (!baseUrl.endsWith("/") && !endpoint.startsWith("/")) return baseUrl + "/" + endpoint;',
-    "  return baseUrl + endpoint;",
-    "}",
-    "",
-    "function globalConfigPath() {",
-    '  const yapiHome = process.env.YAPI_HOME || path.join(os.homedir(), ".yapi");',
-    '  return path.join(yapiHome, "config.toml");',
-    "}",
-    "",
-    "function localConfigPath() {",
-    '  return path.resolve(__dirname, "..", "config.toml");',
-    "}",
-    "",
-    "function ensureDir(dirPath) {",
-    "  try {",
-    "    fs.mkdirSync(dirPath, { recursive: true });",
-    "  } catch {",
-    "    // ignore",
-    "  }",
-    "}",
-    "",
-    "function escapeTomlValue(value) {",
-    '  return String(value || "").replace(/\\\\/g, "\\\\\\\\").replace(/\\"/g, "\\\\\\"");',
-    "}",
-    "",
-    "function formatToml(config) {",
-    '  const orderedKeys = ["base_url", "auth_mode", "email", "password", "token", "project_id"];',
-    '  const lines = ["# YApi CLI config"];',
-    "  for (const key of orderedKeys) {",
-    '    const value = config[key] || "";',
-    '    lines.push(`${key} = \\"${escapeTomlValue(value)}\\"`);',
-    "  }",
-    '  return lines.join("\\n") + "\\n";',
-    "}",
-    "",
-    "function writeConfig(filePath, config) {",
-    "  ensureDir(path.dirname(filePath));",
-    '  fs.writeFileSync(filePath, formatToml(config), "utf8");',
-    "}",
-    "",
-    "function promptText(question) {",
-    "  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });",
-    "  return new Promise((resolve) => {",
-    "    rl.question(question, (answer) => {",
-    "      rl.close();",
-    "      resolve(answer);",
-    "    });",
-    "  });",
-    "}",
-    "",
-    "function promptHidden(question) {",
-    "  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });",
-    "  const originalWrite = rl._writeToOutput;",
-    "  rl._writeToOutput = function writeToOutput(stringToWrite) {",
-    "    if (rl.stdoutMuted) return;",
-    '    if (typeof originalWrite === "function") {',
-    "      originalWrite.call(this, stringToWrite);",
-    "    } else {",
-    "      rl.output.write(stringToWrite);",
-    "    }",
-    "  };",
-    "  rl.stdoutMuted = true;",
-    "  return new Promise((resolve) => {",
-    "    rl.question(question, (answer) => {",
-    "      rl.stdoutMuted = false;",
-    "      rl.close();",
-    "      resolve(answer);",
-    "    });",
-    "  });",
-    "}",
-    "",
-    "async function promptRequired(question, hidden) {",
-    "  while (true) {",
-    "    const answer = hidden ? await promptHidden(question) : await promptText(question);",
-    '    const trimmed = String(answer || "").trim();',
-    "    if (trimmed) return trimmed;",
-    "  }",
-    "}",
-    "",
-    "async function initConfigIfMissing(options) {",
-    "  const hasBaseUrl = Boolean(options.baseUrl);",
-    "  const hasEmail = Boolean(options.email);",
-    "  const hasPassword = Boolean(options.password);",
-    "  if (!hasBaseUrl || !hasEmail || !hasPassword) {",
-    "    if (!process.stdin.isTTY || !process.stdout.isTTY) return null;",
-    "  }",
-    '  const baseUrl = hasBaseUrl ? options.baseUrl : await promptRequired("YApi base URL: ", false);',
-    '  const email = hasEmail ? options.email : await promptRequired("YApi email: ", false);',
-    '  const password = hasPassword ? options.password : await promptRequired("YApi password: ", true);',
-    "  const config = {",
-    "    base_url: baseUrl,",
-    '    auth_mode: "global",',
-    "    email,",
-    "    password,",
-    '    token: options.token || "",',
-    '    project_id: options.projectId || "",',
-    "  };",
-    "  const configPath = globalConfigPath();",
-    "  writeConfig(configPath, config);",
-    "  return { configPath, config };",
-    "}",
-    "",
-    "function parseSimpleToml(text) {",
-    "  const data = {};",
-    '  const lines = String(text || "").split(/\\r?\\n/);',
-    "  for (const rawLine of lines) {",
-    '    const line = rawLine.split("#", 1)[0].split(";", 1)[0].trim();',
-    '    if (!line || line.startsWith("[")) continue;',
-    '    const idx = line.indexOf("=");',
-    "    if (idx === -1) continue;",
-    "    const key = line.slice(0, idx).trim();",
-    "    let value = line.slice(idx + 1).trim();",
-    "    if (!key) continue;",
-    "    if ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))) {",
-    "      value = value.slice(1, -1);",
-    "    }",
-    "    data[key] = value;",
-    "  }",
-    "  return data;",
-    "}",
-    "",
-    "function resolveToken(tokenValue, projectId) {",
-    '  if (!tokenValue) return "";',
-    '  if (tokenValue.includes(",") || tokenValue.includes(":")) {',
-    '    let defaultToken = "";',
-    "    const mapping = {};",
-    '    tokenValue.split(",").forEach((rawPair) => {',
-    "      const pair = rawPair.trim();",
-    "      if (!pair) return;",
-    '      const idx = pair.indexOf(":");',
-    "      if (idx === -1) {",
-    "        defaultToken = pair;",
-    "        return;",
-    "      }",
-    "      const pid = pair.slice(0, idx).trim();",
-    "      const token = pair.slice(idx + 1).trim();",
-    "      if (pid && token) mapping[pid] = token;",
-    "    });",
-    "    if (projectId && mapping[projectId]) return mapping[projectId];",
-    "    if (defaultToken) return defaultToken;",
-    "    const keys = Object.keys(mapping);",
-    "    if (keys.length) return mapping[keys[0]];",
-    "  }",
-    "  return tokenValue;",
-    "}",
-    "",
-    "function getSetCookie(headers) {",
-    "  if (!headers) return [];",
-    '  if (typeof headers.getSetCookie === "function") return headers.getSetCookie();',
-    '  const value = headers.get("set-cookie");',
-    "  return value ? [value] : [];",
-    "}",
-    "",
-    "function extractCookieValue(setCookies, name) {",
-    '  if (!setCookies || !setCookies.length) return "";',
-    "  for (const entry of setCookies) {",
-    '    const parts = String(entry || "").split(";");',
-    "    for (const part of parts) {",
-    "      const item = part.trim();",
-    '      if (item.startsWith(name + "=")) return item.split("=").slice(1).join("=");',
-    "    }",
-    "  }",
-    '  return "";',
-    "}",
-    "",
-    "async function fetchWithTimeout(url, options, timeoutMs) {",
-    "  const controller = new AbortController();",
-    "  const timer = setTimeout(() => controller.abort(), timeoutMs);",
-    "  try {",
-    "    return await fetch(url, { ...options, signal: controller.signal });",
-    "  } finally {",
-    "    clearTimeout(timer);",
-    "  }",
-    "}",
-    "",
-    "async function loginGetCookie(baseUrl, email, password, timeoutMs) {",
-    '  const url = joinUrl(baseUrl, "/api/user/login");',
-    "  const payload = JSON.stringify({ email, password });",
-    "  const response = await fetchWithTimeout(url, {",
-    '    method: "POST",',
-    '    headers: { "Content-Type": "application/json;charset=UTF-8" },',
-    "    body: payload,",
-    "  }, timeoutMs);",
-    "  const bodyText = await response.text();",
-    "  const setCookies = getSetCookie(response.headers);",
-    '  const yapiToken = extractCookieValue(setCookies, "_yapi_token");',
-    '  const yapiUid = extractCookieValue(setCookies, "_yapi_uid");',
-    "  if (!yapiToken) {",
-    '    let message = "login failed: missing _yapi_token cookie";',
-    "    try {",
-    "      const payload = JSON.parse(bodyText);",
-    '      if (payload && typeof payload === "object" && payload.errmsg) message = payload.errmsg;',
-    "    } catch {",
-    "      // ignore",
-    "    }",
-    "    throw new Error(message);",
-    "  }",
-    "  let cookie = `_yapi_token=${yapiToken}`;",
-    "  if (yapiUid) cookie = `${cookie}; _yapi_uid=${yapiUid}`;",
-    "  return cookie;",
-    "}",
-    "",
-    "function buildUrl(baseUrl, endpoint, queryItems, token, tokenParam) {",
-    "  const url = baseUrl ? joinUrl(baseUrl, endpoint) : endpoint;",
-    "  const parsed = new URL(url);",
-    "  if (Array.isArray(queryItems)) {",
-    "    for (const [key, value] of queryItems) {",
-    '      if (key) parsed.searchParams.append(key, value ?? "");',
-    "    }",
-    "  }",
-    "  if (token) {",
-    "    if (!parsed.searchParams.has(tokenParam)) {",
-    "      parsed.searchParams.append(tokenParam, token);",
-    "    }",
-    "  }",
-    "  return parsed.toString();",
-    "}",
-    "",
-    "function parseArgs(argv) {",
-    "  const options = {",
-    "    query: [],",
-    "    header: [],",
-    '    method: "GET",',
-    '    tokenParam: "token",',
-    "    timeout: 30000,",
-    "  };",
-    "  for (let i = 0; i < argv.length; i += 1) {",
-    "    const arg = argv[i];",
-    "    if (!arg) continue;",
-    '    if (arg === "--config") { options.config = argv[++i]; continue; }',
-    '    if (arg.startsWith("--config=")) { options.config = arg.slice(9); continue; }',
-    '    if (arg === "--base-url") { options.baseUrl = argv[++i]; continue; }',
-    '    if (arg.startsWith("--base-url=")) { options.baseUrl = arg.slice(11); continue; }',
-    '    if (arg === "--token") { options.token = argv[++i]; continue; }',
-    '    if (arg.startsWith("--token=")) { options.token = arg.slice(8); continue; }',
-    '    if (arg === "--project-id") { options.projectId = argv[++i]; continue; }',
-    '    if (arg.startsWith("--project-id=")) { options.projectId = arg.slice(13); continue; }',
-    '    if (arg === "--auth-mode") { options.authMode = argv[++i]; continue; }',
-    '    if (arg.startsWith("--auth-mode=")) { options.authMode = arg.slice(12); continue; }',
-    '    if (arg === "--email") { options.email = argv[++i]; continue; }',
-    '    if (arg.startsWith("--email=")) { options.email = arg.slice(8); continue; }',
-    '    if (arg === "--password") { options.password = argv[++i]; continue; }',
-    '    if (arg.startsWith("--password=")) { options.password = arg.slice(11); continue; }',
-    '    if (arg === "--cookie") { options.cookie = argv[++i]; continue; }',
-    '    if (arg.startsWith("--cookie=")) { options.cookie = arg.slice(9); continue; }',
-    '    if (arg === "--token-param") { options.tokenParam = argv[++i]; continue; }',
-    '    if (arg.startsWith("--token-param=")) { options.tokenParam = arg.slice(14); continue; }',
-    '    if (arg === "--method") { options.method = argv[++i]; continue; }',
-    '    if (arg.startsWith("--method=")) { options.method = arg.slice(9); continue; }',
-    '    if (arg === "--path") { options.path = argv[++i]; continue; }',
-    '    if (arg.startsWith("--path=")) { options.path = arg.slice(7); continue; }',
-    '    if (arg === "--url") { options.url = argv[++i]; continue; }',
-    '    if (arg.startsWith("--url=")) { options.url = arg.slice(6); continue; }',
-    '    if (arg === "--query") { options.query.push(argv[++i]); continue; }',
-    '    if (arg.startsWith("--query=")) { options.query.push(arg.slice(8)); continue; }',
-    '    if (arg === "--header") { options.header.push(argv[++i]); continue; }',
-    '    if (arg.startsWith("--header=")) { options.header.push(arg.slice(9)); continue; }',
-    '    if (arg === "--data") { options.data = argv[++i]; continue; }',
-    '    if (arg.startsWith("--data=")) { options.data = arg.slice(7); continue; }',
-    '    if (arg === "--data-file") { options.dataFile = argv[++i]; continue; }',
-    '    if (arg.startsWith("--data-file=")) { options.dataFile = arg.slice(12); continue; }',
-    '    if (arg === "--timeout") { options.timeout = Number(argv[++i]); continue; }',
-    '    if (arg.startsWith("--timeout=")) { options.timeout = Number(arg.slice(10)); continue; }',
-    '    if (arg === "--no-pretty") { options.noPretty = true; continue; }',
-    '    if (arg === "--help" || arg === "-h") { options.help = true; continue; }',
-    "  }",
-    "  return options;",
-    "}",
-    "",
-    "function usage() {",
-    "  return [",
-    '    "Usage:",',
-    '    "  node yapi_request.js --path /api/interface/get --query id=123",',
-    '    "Options:",',
-    '    "  --config <path>        config file path (default: ~/.yapi/config.toml)",',
-    '    "  --base-url <url>       YApi base URL",',
-    '    "  --token <token>        project token (supports projectId:token)",',
-    '    "  --project-id <id>      select token for project",',
-    '    "  --auth-mode <mode>     token or global",',
-    '    "  --email <email>        login email for global mode",',
-    '    "  --password <pwd>       login password for global mode",',
-    '    "  --path <path>          API path (e.g., /api/interface/get)",',
-    '    "  --url <url>            full URL (overrides base-url/path)",',
-    '    "  --query key=value      query param (repeatable)",',
-    '    "  --header Header:Value  request header (repeatable)",',
-    '    "  --method <method>      HTTP method",',
-    '    "  --data <payload>       request body (JSON or text)",',
-    '    "  --data-file <file>     request body file",',
-    '    "  --timeout <ms>         request timeout in ms",',
-    '    "  --no-pretty            print raw response",',
-    '  ].join("\\n");',
-    "}",
-    "",
-    "async function main() {",
-    "  const options = parseArgs(process.argv.slice(2));",
-    "  if (options.help) {",
-    "    console.log(usage());",
-    "    return 0;",
-    "  }",
-    "",
-    "  if (options.url && options.path) {",
-    '    console.error("use --url or --path, not both");',
-    "    return 2;",
-    "  }",
-    "",
-    "  if (!options.url && !options.path) {",
-    '    console.error("missing --path or --url");',
-    "    console.error(usage());",
-    "    return 2;",
-    "  }",
-    "",
-    "  let config = {};",
-    '  let configPath = options.config || "";',
-    "  if (options.config) {",
-    "    if (fs.existsSync(configPath)) {",
-    '      config = parseSimpleToml(fs.readFileSync(configPath, "utf8"));',
-    "    } else {",
-    "      const init = await initConfigIfMissing(options);",
-    "      if (init) {",
-    "        config = init.config;",
-    "        configPath = init.configPath;",
-    "      } else {",
-    "        console.error(`missing config file: ${configPath}`);",
-    "        return 2;",
-    "      }",
-    "    }",
-    "  } else {",
-    "    const globalPath = globalConfigPath();",
-    "    const localPath = localConfigPath();",
-    "    if (fs.existsSync(globalPath)) {",
-    "      configPath = globalPath;",
-    '      config = parseSimpleToml(fs.readFileSync(globalPath, "utf8"));',
-    "    } else if (fs.existsSync(localPath)) {",
-    "      configPath = localPath;",
-    '      config = parseSimpleToml(fs.readFileSync(localPath, "utf8"));',
-    "    } else {",
-    "      const init = await initConfigIfMissing(options);",
-    "      if (init) {",
-    "        config = init.config;",
-    "        configPath = init.configPath;",
-    "      } else {",
-    '        console.error("missing config: create ~/.yapi/config.toml or pass --config");',
-    "        return 2;",
-    "      }",
-    "    }",
-    "  }",
-    "",
-    '  const baseUrl = options.url ? null : (options.baseUrl || config.base_url || "");',
-    "  const endpoint = options.url || options.path;",
-    "  if (!options.url && !baseUrl) {",
-    '    console.error("missing --base-url or config base_url");',
-    "    return 2;",
-    "  }",
-    "",
-    '  const projectId = options.projectId || config.project_id || "";',
-    '  const rawToken = options.token || config.token || "";',
-    "  const token = resolveToken(rawToken, projectId);",
-    "",
-    '  let authMode = (options.authMode || config.auth_mode || "").trim().toLowerCase();',
-    "  if (!authMode) {",
-    '    authMode = token ? "token" : (options.email || options.password || config.email || config.password) ? "global" : "token";',
-    "  }",
-    '  if (authMode !== "token" && authMode !== "global") {',
-    '    console.error("invalid --auth-mode (use token or global)");',
-    "    return 2;",
-    "  }",
-    "",
-    "  const headers = {};",
-    "  for (const header of options.header || []) {",
-    "    const [key, value] = parseHeader(header);",
-    "    headers[key] = value;",
-    "  }",
-    "",
-    "  if (options.cookie) {",
-    "    headers.Cookie = options.cookie;",
-    '  } else if (authMode === "global") {',
-    "    const email = options.email || config.email;",
-    "    const password = options.password || config.password;",
-    "    if (!email || !password) {",
-    '      console.error("missing email/password for global auth");',
-    "      return 2;",
-    "    }",
-    "    try {",
-    "      headers.Cookie = await loginGetCookie(baseUrl, email, password, options.timeout);",
-    "    } catch (error) {",
-    "      console.error(error && error.message ? error.message : String(error));",
-    "      return 2;",
-    "    }",
-    "  }",
-    "",
-    "  const queryItems = [];",
-    "  for (const query of options.query || []) {",
-    "    queryItems.push(parseKeyValue(query));",
-    "  }",
-    '  const url = buildUrl(baseUrl, endpoint, queryItems, authMode === "token" ? token : "", options.tokenParam);',
-    "",
-    "  let dataRaw = null;",
-    "  if (options.dataFile) {",
-    '    dataRaw = fs.readFileSync(options.dataFile, "utf8");',
-    "  } else if (options.data !== undefined) {",
-    "    dataRaw = options.data;",
-    "  }",
-    "",
-    "  let body;",
-    '  if (dataRaw !== null && options.method.toUpperCase() !== "GET" && options.method.toUpperCase() !== "HEAD") {',
-    "    try {",
-    "      const parsed = JSON.parse(dataRaw);",
-    "      body = JSON.stringify(parsed);",
-    '      if (!headers["Content-Type"]) headers["Content-Type"] = "application/json";',
-    "    } catch {",
-    "      body = String(dataRaw);",
-    '      if (!headers["Content-Type"]) headers["Content-Type"] = "text/plain";',
-    "    }",
-    "  }",
-    "",
-    "  let response;",
-    "  try {",
-    "    response = await fetchWithTimeout(url, {",
-    "      method: options.method.toUpperCase(),",
-    "      headers,",
-    "      body,",
-    "    }, options.timeout);",
-    "  } catch (error) {",
-    '    console.error("request failed: " + (error && error.message ? error.message : String(error)));',
-    "    return 2;",
-    "  }",
-    "",
-    "  const text = await response.text();",
-    "  if (options.noPretty) {",
-    "    console.log(text);",
-    "    return 0;",
-    "  }",
-    "  try {",
-    "    const payload = JSON.parse(text);",
-    "    console.log(JSON.stringify(payload, null, 2));",
-    "  } catch {",
-    "    console.log(text);",
-    "  }",
-    "  return 0;",
-    "}",
-    "",
-    "main().then((code) => {",
-    "  process.exitCode = code;",
-    "});",
-    "",
-].join("\n");
+const SKILL_TEMPLATE_DIR = "skill-template";
+const SKILL_TEMPLATE_FILE = "SKILL.md";
+function detectPackageManager() {
+    const userAgent = process.env.npm_config_user_agent || "";
+    if (userAgent.includes("pnpm"))
+        return "pnpm";
+    if (userAgent.includes("yarn"))
+        return "yarn";
+    if (userAgent.includes("npm"))
+        return "npm";
+    const execPath = process.env.npm_execpath || "";
+    if (execPath.includes("pnpm"))
+        return "pnpm";
+    if (execPath.includes("yarn"))
+        return "yarn";
+    if (execPath.includes("npm"))
+        return "npm";
+    return "unknown";
+}
+function resolvePackageRoot(startDir) {
+    let current = path_1.default.resolve(startDir);
+    const { root } = path_1.default.parse(current);
+    while (true) {
+        const candidate = path_1.default.join(current, "package.json");
+        if (fs_1.default.existsSync(candidate)) {
+            let pkgName;
+            try {
+                const pkg = JSON.parse(fs_1.default.readFileSync(candidate, "utf8"));
+                pkgName = pkg.name;
+            }
+            catch {
+                pkgName = undefined;
+            }
+            if (pkgName === "@leeguoo/yapi-mcp")
+                return current;
+        }
+        if (current === root)
+            break;
+        current = path_1.default.dirname(current);
+    }
+    return path_1.default.resolve(__dirname, "..", "..");
+}
 function parseSimpleToml(text) {
     const data = {};
     for (const rawLine of text.split(/\r?\n/)) {
@@ -564,19 +94,6 @@ function formatToml(config) {
     }
     return `${lines.join("\n")}\n`;
 }
-function writeFileIfNeeded(filePath, contents, force) {
-    if (!force && fs_1.default.existsSync(filePath))
-        return false;
-    fs_1.default.writeFileSync(filePath, contents, "utf8");
-    return true;
-}
-function ensureExecutable(filePath) {
-    try {
-        fs_1.default.chmodSync(filePath, 0o755);
-    }
-    catch {
-    }
-}
 function ensurePrivate(filePath) {
     try {
         fs_1.default.chmodSync(filePath, 0o600);
@@ -653,6 +170,7 @@ async function runInstallSkill(rawArgs) {
         "yapi-home": { type: "string", describe: "Override YApi config home (default: ~/.yapi)" },
         "codex-home": { type: "string", describe: "Override CODEX_HOME" },
         "claude-home": { type: "string", describe: "Override Claude home (default: ~/.claude)" },
+        "cursor-home": { type: "string", describe: "Override Cursor home (default: ~/.cursor)" },
         force: {
             type: "boolean",
             default: false,
@@ -664,10 +182,12 @@ async function runInstallSkill(rawArgs) {
     const yapiHome = argv["yapi-home"] || process.env.YAPI_HOME || path_1.default.join(os_1.default.homedir(), ".yapi");
     const codexHome = argv["codex-home"] || process.env.CODEX_HOME || path_1.default.join(os_1.default.homedir(), ".codex");
     const claudeHome = argv["claude-home"] || process.env.CLAUDE_HOME || path_1.default.join(os_1.default.homedir(), ".claude");
+    const cursorHome = argv["cursor-home"] || process.env.CURSOR_HOME || path_1.default.join(os_1.default.homedir(), ".cursor");
     const globalConfigPath = path_1.default.join(yapiHome, "config.toml");
     const targets = [
         { label: "Codex", root: path_1.default.join(codexHome, "skills", SKILL_NAME) },
         { label: "Claude", root: path_1.default.join(claudeHome, "skills", SKILL_NAME) },
+        { label: "Cursor", root: path_1.default.join(cursorHome, "skills", SKILL_NAME) },
     ];
     const seenRoots = new Set();
     const uniqueTargets = targets.filter((target) => {
@@ -680,15 +200,6 @@ async function runInstallSkill(rawArgs) {
     if (fs_1.default.existsSync(globalConfigPath)) {
         existingConfig = parseSimpleToml(fs_1.default.readFileSync(globalConfigPath, "utf8"));
     }
-    else {
-        for (const target of uniqueTargets) {
-            const configPath = path_1.default.join(target.root, "config.toml");
-            if (fs_1.default.existsSync(configPath)) {
-                existingConfig = parseSimpleToml(fs_1.default.readFileSync(configPath, "utf8"));
-                break;
-            }
-        }
-    }
     const merged = { ...existingConfig };
     if (argv["yapi-base-url"] || process.env.YAPI_BASE_URL) {
         merged.base_url = argv["yapi-base-url"] || process.env.YAPI_BASE_URL || "";
@@ -728,31 +239,29 @@ async function runInstallSkill(rawArgs) {
         }
     }
     merged.password = password;
+    const packageRoot = resolvePackageRoot(__dirname);
+    const templatePath = path_1.default.join(packageRoot, SKILL_TEMPLATE_DIR, SKILL_TEMPLATE_FILE);
+    if (!fs_1.default.existsSync(templatePath)) {
+        const manager = detectPackageManager();
+        throw new Error(`Missing skill template: ${templatePath} (package root: ${packageRoot}, manager: ${manager})`);
+    }
+    const skillTemplate = fs_1.default.readFileSync(templatePath, "utf8");
     const installedRoots = [];
-    const configPaths = [];
     fs_1.default.mkdirSync(yapiHome, { recursive: true });
     fs_1.default.writeFileSync(globalConfigPath, formatToml(merged), "utf8");
     ensurePrivate(globalConfigPath);
-    configPaths.push(globalConfigPath);
     for (const target of uniqueTargets) {
-        const scriptsDir = path_1.default.join(target.root, "scripts");
-        const configPath = path_1.default.join(target.root, "config.toml");
+        if (fs_1.default.existsSync(target.root)) {
+            fs_1.default.rmSync(target.root, { recursive: true, force: true });
+        }
+        fs_1.default.mkdirSync(target.root, { recursive: true });
         const skillPath = path_1.default.join(target.root, "SKILL.md");
-        const scriptPath = path_1.default.join(scriptsDir, "yapi_request.js");
-        fs_1.default.mkdirSync(scriptsDir, { recursive: true });
-        writeFileIfNeeded(skillPath, SKILL_MD, argv.force ?? false);
-        const scriptWritten = writeFileIfNeeded(scriptPath, REQUEST_SCRIPT, argv.force ?? false);
-        if (scriptWritten)
-            ensureExecutable(scriptPath);
-        fs_1.default.writeFileSync(configPath, formatToml(merged), "utf8");
-        ensurePrivate(configPath);
+        fs_1.default.writeFileSync(skillPath, skillTemplate, "utf8");
         installedRoots.push(`${target.label}: ${target.root}`);
-        configPaths.push(configPath);
     }
     console.log(`Installed skill '${SKILL_NAME}' at:`);
     installedRoots.forEach((entry) => console.log(`- ${entry}`));
-    console.log("Config written to:");
-    configPaths.forEach((entry) => console.log(`- ${entry}`));
-    console.log("Restart Codex/Claude Code to pick up new skills.");
+    console.log(`Config written to: ${globalConfigPath}`);
+    console.log("Restart Codex/Claude Code/Cursor to pick up new skills.");
 }
 //# sourceMappingURL=install.js.map

package/dist/skill/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/skill/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/skill/install.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leeguoo/yapi-mcp",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "YApi Auto MCP Server - Model Context Protocol server for YApi integration, enables AI tools like Cursor to interact with YApi API documentation",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "skill-template"
   ],
   "scripts": {
     "build": "tsc && tsc-alias",

package/skill-template/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: yapi
+description: Query and sync YApi interface documentation. Use when user mentions "yapi 接口文档", YAPI docs, asks for request/response details, or needs docs sync. Also triggers when user pastes a YApi URL that matches the configured base_url.
+---
+
+# YApi interface docs
+
+## URL Detection
+
+When user provides a URL, check if it matches the configured YApi instance:
+
+1. Read config to get base_url:
+```bash
+cat ~/.yapi/config.toml | grep base_url
+```
+
+2. If the URL's origin matches `base_url`, use yapi CLI to operate:
+   - Extract `project_id` from URL path (e.g., `/project/123/...` → project_id=123)
+   - Extract `api_id` from URL path (e.g., `.../api/456` → api_id=456)
+   - Use `yapi --path /api/interface/get --query id=<api_id>` to fetch details
+
+3. Example URL patterns:
+   - `https://yapi.example.com/project/123/interface/api/456` → project=123, api=456
+   - `https://yapi.example.com/project/123/interface/api/cat_789` → project=123, category=789
+
+## Prerequisites
+
+### Check if yapi CLI is installed
+```bash
+yapi --version
+```
+
+### If not installed, ask user to install globally
+```bash
+npm install -g @leeguoo/yapi-mcp
+# or
+pnpm add -g @leeguoo/yapi-mcp
+```
+
+### Check login status
+```bash
+yapi whoami
+```
+
+### If not logged in, login interactively
+```bash
+yapi login
+```
+This will prompt for:
+- YApi base URL (e.g., https://yapi.example.com)
+- Email
+- Password
+
+Config is saved to `~/.yapi/config.toml`.
+
+## Workflow
+1. If user provides a YApi URL, check if it matches configured `base_url` in `~/.yapi/config.toml`.
+2. Ensure yapi CLI is installed (prompt user to install globally if missing).
+3. Check login status with `yapi whoami`; if not logged in, run `yapi login`.
+4. Load config from `~/.yapi/config.toml` (base_url, auth_mode, email/password or token, optional project_id).
+5. Identify the target interface by id, URL, or keyword; ask for project/category ids if needed.
+6. Call YApi endpoints with the CLI (see examples below) to fetch raw JSON.
+7. Summarize method, path, headers, query/body schema, response schema, and examples.
+
+## CLI Usage
+- Config location: `~/.yapi/config.toml`
+- Auth cache: `~/.yapi-mcp/auth-*.json`
+
+### Common commands
+```bash
+# Check version
+yapi --version
+
+# Show help
+yapi -h
+
+# Check current user
+yapi whoami
+
+# Login (interactive)
+yapi login
+
+# Search interfaces
+yapi search --q keyword
+
+# Get interface by ID
+yapi --path /api/interface/get --query id=123
+
+# List interfaces in category
+yapi --path /api/interface/list_cat --query catid=123
+```
+
+## Docs sync
+- Bind local docs to YApi category with `yapi docs-sync bind add --name <binding> --dir <path> --project-id <id> --catid <id>` (stored in `.yapi/docs-sync.json`).
+- Sync with `yapi docs-sync --binding <binding>` or run all bindings with `yapi docs-sync`.
+- Default syncs only changed files; use `--force` to sync everything.
+- Mermaid rendering depends on `mmdc` (auto-installed if possible; failures do not block sync).
+- For full Markdown render, install `pandoc` (manual install required).
+- Extra mappings (generated after docs-sync run in binding mode):
+  - `.yapi/docs-sync.links.json`: local docs to YApi doc URLs.
+  - `.yapi/docs-sync.projects.json`: cached project metadata/envs.
+  - `.yapi/docs-sync.deployments.json`: local docs to deployed URLs.
+
+## Interface creation tips
+- When adding interfaces, always set `req_body_type` (use `json` if unsure) and provide `res_body` (prefer JSON Schema). Empty values can make `/api/interface/add` fail.
+- Keep request/response structures in `req_*` / `res_body` instead of stuffing them into `desc` or `markdown`.