@mcohenchen/pingcode-mcp 0.0.0-stage → 0.3.2

package/dist/comments/index.js

@@ -0,0 +1,81 @@
+import { PingCodeError } from "../client/errors.js";
+import { LONG_ID_RE } from "../client/refs.js";
+import { getWorkItem } from "../pjm/index.js";
+export function summarizeComment(c) {
+    const by = c?.created_by;
+    return {
+        id: c.id,
+        content: typeof c.content === "string" ? c.content : c.content == null ? "" : String(c.content),
+        is_deleted: c.is_deleted,
+        created_at: c.created_at,
+        updated_at: c.updated_at,
+        created_by: by ? { id: by.id, name: by.name, display_name: by.display_name } : null,
+    };
+}
+/**
+ * Deleted comments stay in list results with `is_deleted=1` and empty content. When the flag is
+ * absent (e.g. /v1/project/work_items/{id}/comments omits it), empty content without attachments
+ * is treated as deleted.
+ */
+export function isDeletedComment(c) {
+    if (c.is_deleted !== undefined && c.is_deleted !== null)
+        return !!c.is_deleted;
+    return !c.content && !(Array.isArray(c.attachments) && c.attachments.length);
+}
+async function resolveWorkItemBrief(client, ref) {
+    const w = await getWorkItem(client, ref);
+    return { id: w.id, identifier: w.identifier, title: w.title };
+}
+const commentQuery = (workItemId) => ({ principal_type: "work_item", principal_id: workItemId });
+export async function listWorkItemComments(client, workItemRef, opts = {}) {
+    const workItem = await resolveWorkItemBrief(client, workItemRef);
+    // /v1/comments carries is_deleted; /v1/project/work_items/{id}/comments does not.
+    const fetchPage = (pageIndex, pageSize) => client.get("/v1/comments", { ...commentQuery(workItem.id), page_index: pageIndex, page_size: pageSize });
+    const mark = (c) => {
+        const s = summarizeComment(c);
+        return isDeletedComment(c) ? { ...s, deleted: true } : s;
+    };
+    if (opts.includeDeleted && (opts.pageIndex !== undefined || opts.pageSize !== undefined)) {
+        const res = await fetchPage(opts.pageIndex, opts.pageSize);
+        const values = res?.values ?? [];
+        return {
+            work_item: workItem,
+            page_index: res?.page_index,
+            page_size: res?.page_size,
+            total: res?.total ?? values.length,
+            comments: values.map(mark),
+        };
+    }
+    // Filtering deleted rows (or no paging given): page through so the filtered total is accurate.
+    const pageSize = 100;
+    const all = [];
+    for (let pageIndex = 0; pageIndex < 50; pageIndex++) {
+        const res = await fetchPage(pageIndex, pageSize);
+        const values = res?.values ?? [];
+        all.push(...values);
+        const total = typeof res?.total === "number" ? res.total : undefined;
+        if (values.length < pageSize || (total !== undefined && all.length >= total))
+            break;
+    }
+    const kept = opts.includeDeleted ? all : all.filter((c) => !isDeletedComment(c));
+    return { work_item: workItem, total: kept.length, comments: kept.map(mark) };
+}
+export async function createWorkItemComment(client, workItemRef, content) {
+    if (!content.trim())
+        throw new PingCodeError("评论内容不能为空");
+    const workItem = await resolveWorkItemBrief(client, workItemRef);
+    const res = await client.post(`/v1/project/work_items/${workItem.id}/comments`, { content });
+    if (!res?.id)
+        throw new PingCodeError("创建评论的响应中没有 id 字段");
+    return { work_item: workItem, comment: summarizeComment(res) };
+}
+export async function deleteWorkItemComment(client, workItemRef, commentId) {
+    const id = commentId.trim();
+    if (!LONG_ID_RE.test(id))
+        throw new PingCodeError(`comment_id 应为 24 位十六进制 id: ${commentId}`);
+    const workItem = await resolveWorkItemBrief(client, workItemRef);
+    const res = await client.delete(`/v1/comments/${id}`, commentQuery(workItem.id));
+    const comment = res?.id ? summarizeComment(res) : { id, content: "" };
+    return { work_item: workItem, comment: { ...comment, is_deleted: comment.is_deleted ?? 1, deleted: true } };
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js

@@ -0,0 +1,354 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import dotenv from "dotenv";
+import { PingCodeError } from "../client/errors.js";
+// Load .env from the package root (so it works regardless of cwd, e.g. when
+// launched by Claude Desktop), then from cwd. quiet: stdout is the MCP channel.
+// Variables already present in the environment always win.
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+dotenv.config({ path: path.join(packageRoot, ".env"), quiet: true });
+dotenv.config({ quiet: true });
+export const DEFAULT_API_BASE_URL = "https://open.pingcode.com";
+export const DEFAULT_PROFILE_NAME = "default";
+const FIELD_ALIASES = {
+    name: ["name"],
+    apiBaseUrl: ["apiBaseUrl", "api_base_url"],
+    accessToken: ["accessToken", "access_token"],
+    webBaseUrl: ["webBaseUrl", "web_base_url"],
+    defaultSpaceIdentifier: ["defaultSpaceIdentifier", "default_space_identifier"],
+};
+const MAX_RETRIES_KEYS = ["maxRetries", "max_retries"];
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const blankToUndef = (v) => {
+    const t = v?.trim();
+    return t ? t : undefined;
+};
+/** Parse a non-negative integer from a number or numeric string; undefined if invalid. */
+export function parseNonNegativeInt(v) {
+    const n = typeof v === "number" ? v : typeof v === "string" && v.trim() ? Number(v.trim()) : NaN;
+    return Number.isInteger(n) && n >= 0 ? n : undefined;
+}
+function readString(obj, keys, where) {
+    for (const key of keys) {
+        const v = obj[key];
+        if (v === undefined || v === null)
+            continue;
+        if (typeof v !== "string")
+            throw new PingCodeError(`${where}: 字段 ${key} 必须是字符串`);
+        const t = v.trim();
+        if (t)
+            return t;
+    }
+    return undefined;
+}
+function parseRawProfile(value, where) {
+    if (!isObject(value))
+        throw new PingCodeError(`${where}: profile 必须是 JSON 对象`);
+    const out = {};
+    for (const [field, keys] of Object.entries(FIELD_ALIASES)) {
+        const v = readString(value, keys, where);
+        if (v !== undefined)
+            out[field] = v;
+    }
+    for (const key of MAX_RETRIES_KEYS) {
+        const v = value[key];
+        if (v === undefined || v === null || v === "")
+            continue;
+        const n = parseNonNegativeInt(v);
+        if (n === undefined)
+            throw new PingCodeError(`${where}: 字段 ${key} 必须是非负整数`);
+        out.maxRetries = n;
+        break;
+    }
+    return out;
+}
+/**
+ * Accepted shapes (both for PINGCODE_PROFILES and the config file):
+ *   - [ {profile}, ... ]
+ *   - { "defaultProfile": "x", "profiles": [ {profile}, ... ] }
+ *   - { "defaultProfile": "x", "profiles": { "name": {profile}, ... } }
+ *   - { profile }   (a single profile object)
+ */
+export function parseProfilesConfig(value, source) {
+    let defaultProfile;
+    let entries;
+    if (Array.isArray(value)) {
+        entries = value.map((v) => ({ value: v }));
+    }
+    else if (isObject(value)) {
+        defaultProfile = readString(value, ["defaultProfile", "default_profile"], source);
+        const p = value.profiles;
+        if (Array.isArray(p)) {
+            entries = p.map((v) => ({ value: v }));
+        }
+        else if (isObject(p)) {
+            entries = Object.entries(p).map(([key, v]) => ({ value: v, key }));
+        }
+        else if (p === undefined && FIELD_ALIASES.accessToken.some((k) => k in value)) {
+            entries = [{ value }];
+        }
+        else {
+            throw new PingCodeError(`${source}: 需要 "profiles" 数组/对象，或单个 profile 对象`);
+        }
+    }
+    else {
+        throw new PingCodeError(`${source}: 配置必须是 JSON 数组或对象`);
+    }
+    const profiles = entries.map(({ value: v, key }, i) => {
+        const where = `${source} profiles[${key ?? i}]`;
+        const prof = parseRawProfile(v, where);
+        prof.name ??= key;
+        if (!prof.name) {
+            if (entries.length > 1)
+                throw new PingCodeError(`${where}: 存在多个 profile 时每个都必须设置 name`);
+            prof.name = DEFAULT_PROFILE_NAME;
+        }
+        return prof;
+    });
+    const seen = new Set();
+    for (const p of profiles) {
+        if (seen.has(p.name))
+            throw new PingCodeError(`${source}: profile 名称重复: ${p.name}`);
+        seen.add(p.name);
+    }
+    return { defaultProfile, profiles };
+}
+function parseJson(text, source) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (err) {
+        throw new PingCodeError(`${source} 不是合法的 JSON: ${err.message}`);
+    }
+}
+// ---------- URL helpers ----------
+/** Normalize a base URL: trim, default to https:// when no scheme, drop trailing slashes. */
+export function normalizeBaseUrl(input, where) {
+    let s = input.trim();
+    if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(s))
+        s = `https://${s}`;
+    let url;
+    try {
+        url = new URL(s);
+    }
+    catch {
+        throw new PingCodeError(`${where}: 无效的 URL: ${input}`);
+    }
+    return (url.origin + url.pathname).replace(/\/+$/, "");
+}
+/** Lower-cased host (with port, if any) of a URL or bare host; undefined if it cannot be parsed. */
+export function hostOf(urlOrHost) {
+    if (!urlOrHost?.trim())
+        return undefined;
+    let s = urlOrHost.trim();
+    if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(s))
+        s = `https://${s}`;
+    try {
+        return new URL(s).host.toLowerCase() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---------- loading ----------
+export function expandHome(p) {
+    return p === "~" || p.startsWith("~/") || p.startsWith("~\\") ? path.join(os.homedir(), p.slice(1)) : p;
+}
+/** Path of the config file and whether it was set explicitly (PINGCODE_CONFIG). */
+export function configFilePath(env = process.env) {
+    const override = blankToUndef(env.PINGCODE_CONFIG);
+    if (override)
+        return { path: path.resolve(expandHome(override)), explicit: true };
+    const base = blankToUndef(env.XDG_CONFIG_HOME) ?? path.join(os.homedir(), ".config");
+    return { path: path.join(base, "pingcode-mcp", "config.json"), explicit: false };
+}
+function finalizeProfile(p, source) {
+    const where = `profile "${p.name}" (${source})`;
+    if (!p.accessToken)
+        throw new PingCodeError(`${where} 缺少 accessToken`);
+    return {
+        name: p.name,
+        apiBaseUrl: normalizeBaseUrl(p.apiBaseUrl ?? DEFAULT_API_BASE_URL, `${where} apiBaseUrl`),
+        accessToken: p.accessToken,
+        webBaseUrl: p.webBaseUrl ? normalizeBaseUrl(p.webBaseUrl, `${where} webBaseUrl`) : undefined,
+        defaultSpaceIdentifier: p.defaultSpaceIdentifier,
+        maxRetries: p.maxRetries,
+    };
+}
+/**
+ * Load profiles. Sources, highest priority first:
+ *   1. PINGCODE_PROFILES (JSON)
+ *   2. config file (PINGCODE_CONFIG or ~/.config/pingcode-mcp/config.json)
+ *   3. legacy single-token env (PINGCODE_ACCESS_TOKEN …) — only when 1 and 2 define no profiles
+ * Profiles with the same name in 1 and 2 are merged field by field (1 wins).
+ * Default profile: PINGCODE_DEFAULT_PROFILE > defaultProfile in 1 > in 2 > profile named
+ * "default" > first profile.
+ */
+export function loadProfiles(options = {}) {
+    const env = options.env ?? process.env;
+    const sources = [];
+    const warnings = [];
+    const merged = new Map();
+    let defaultFromJson;
+    const addAll = (cfg, source) => {
+        for (const p of cfg.profiles) {
+            const prev = merged.get(p.name);
+            if (!prev) {
+                merged.set(p.name, { profile: { ...p }, source });
+            }
+            else {
+                for (const [k, v] of Object.entries(p))
+                    if (v !== undefined)
+                        prev.profile[k] = v;
+                prev.source = `${prev.source} + ${source}`;
+            }
+        }
+        defaultFromJson = cfg.defaultProfile ?? defaultFromJson;
+    };
+    // 2. config file (lower priority, applied first so env JSON overrides it)
+    if (options.configPath !== false) {
+        const cfgPath = options.configPath !== undefined
+            ? { path: path.resolve(expandHome(options.configPath)), explicit: true }
+            : configFilePath(env);
+        let text;
+        try {
+            text = fs.readFileSync(cfgPath.path, "utf8");
+        }
+        catch (err) {
+            const code = err.code;
+            if (cfgPath.explicit || code !== "ENOENT") {
+                throw new PingCodeError(`无法读取配置文件 ${cfgPath.path}: ${err.message}`);
+            }
+        }
+        if (text !== undefined && text.trim()) {
+            const source = `config file ${cfgPath.path}`;
+            addAll(parseProfilesConfig(parseJson(text, source), source), source);
+            sources.push(source);
+        }
+    }
+    // 1. PINGCODE_PROFILES
+    const profilesJson = blankToUndef(env.PINGCODE_PROFILES);
+    if (profilesJson) {
+        const source = "env PINGCODE_PROFILES";
+        addAll(parseProfilesConfig(parseJson(profilesJson, source), source), source);
+        sources.push(source);
+    }
+    // 3. legacy single token
+    const legacyToken = blankToUndef(env.PINGCODE_ACCESS_TOKEN);
+    if (merged.size === 0 && legacyToken) {
+        const source = "env PINGCODE_ACCESS_TOKEN";
+        merged.set(DEFAULT_PROFILE_NAME, {
+            profile: {
+                name: DEFAULT_PROFILE_NAME,
+                accessToken: legacyToken,
+                apiBaseUrl: blankToUndef(env.PINGCODE_API_BASE_URL),
+                webBaseUrl: blankToUndef(env.PINGCODE_WEB_BASE_URL),
+                defaultSpaceIdentifier: blankToUndef(env.PINGCODE_DEFAULT_SPACE),
+            },
+            source,
+        });
+        sources.push(source);
+    }
+    else if (merged.size > 0 && legacyToken) {
+        warnings.push(`已从 ${sources.join(", ")} 加载 profile，忽略 PINGCODE_ACCESS_TOKEN / PINGCODE_API_BASE_URL / PINGCODE_WEB_BASE_URL / PINGCODE_DEFAULT_SPACE`);
+    }
+    const profiles = [...merged.values()].map(({ profile, source }) => finalizeProfile(profile, source));
+    let defaultProfile;
+    const requested = blankToUndef(env.PINGCODE_DEFAULT_PROFILE) ?? defaultFromJson;
+    if (requested) {
+        const found = findByName(profiles, requested);
+        if (!found) {
+            throw new PingCodeError(`默认 profile "${requested}" 不存在。${describeProfiles(profiles)}`);
+        }
+        defaultProfile = found.name;
+    }
+    else if (profiles.length) {
+        defaultProfile = (findByName(profiles, DEFAULT_PROFILE_NAME) ?? profiles[0]).name;
+    }
+    return { profiles, defaultProfile, sources, warnings };
+}
+let cached;
+/** Profiles from the real environment, loaded once and cached. */
+export function getProfiles() {
+    return (cached ??= loadProfiles());
+}
+/** Drop the cached profile set (next call re-reads env / config file). */
+export function resetProfilesCache() {
+    cached = undefined;
+}
+// ---------- resolving ----------
+function findByName(profiles, name) {
+    const exact = profiles.find((p) => p.name === name);
+    if (exact)
+        return exact;
+    const ci = profiles.filter((p) => p.name.toLowerCase() === name.toLowerCase());
+    return ci.length === 1 ? ci[0] : undefined;
+}
+/** Bulleted list of profiles for error messages. */
+export function describeProfiles(profiles, defaultName) {
+    if (!profiles.length)
+        return "当前没有配置任何 profile。";
+    const lines = profiles.map((p) => `  - ${p.name}${p.name === defaultName ? " (默认)" : ""}: webBaseUrl=${p.webBaseUrl ?? "(未设置)"}, apiBaseUrl=${p.apiBaseUrl}`);
+    return `可用 profile:\n${lines.join("\n")}`;
+}
+function noProfileHelp() {
+    return (`未配置任何 PingCode profile。请运行 \`pingcode-mcp init\` 生成配置文件 ${configFilePath().path}，` +
+        "填入 accessToken 后重启 MCP 客户端（客户端只需配置 command: pingcode-mcp）。" +
+        "本机开发也可用 PINGCODE_ACCESS_TOKEN 环境变量。");
+}
+/** Resolve a profile by name, or the default profile when name is omitted. */
+export function resolveProfile(name, set = getProfiles()) {
+    if (!set.profiles.length)
+        throw new PingCodeError(noProfileHelp());
+    const wanted = blankToUndef(name);
+    if (!wanted)
+        return findByName(set.profiles, set.defaultProfile);
+    const found = findByName(set.profiles, wanted);
+    if (!found) {
+        throw new PingCodeError(`未知 profile "${wanted}"。${describeProfiles(set.profiles, set.defaultProfile)}`);
+    }
+    return found;
+}
+/** Profiles whose webBaseUrl host equals the given host (case-insensitive). */
+export function profilesForHost(host, set = getProfiles()) {
+    const h = hostOf(host);
+    if (!h)
+        return [];
+    return set.profiles.filter((p) => hostOf(p.webBaseUrl) === h);
+}
+/**
+ * Pick the profile for a request.
+ *   - explicit `profile` always wins
+ *   - otherwise, if a URL host is known, the profile whose webBaseUrl host matches it
+ *     (several matches → the default profile if it is one of them, else an error;
+ *      no match → error, except a single profile without webBaseUrl is used as is)
+ *   - otherwise the default profile
+ */
+export function selectProfile(opts, set = getProfiles()) {
+    if (blankToUndef(opts.profile) || !opts.host)
+        return resolveProfile(opts.profile, set);
+    if (!set.profiles.length)
+        throw new PingCodeError(noProfileHelp());
+    const host = hostOf(opts.host) ?? opts.host;
+    const matches = profilesForHost(host, set);
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        const def = matches.find((p) => p.name === set.defaultProfile);
+        if (def)
+            return def;
+        throw new PingCodeError(`有多个 profile 的 webBaseUrl 匹配主机 ${host}: ${matches.map((p) => p.name).join(", ")}。请通过 profile 参数指定。\n` +
+            describeProfiles(set.profiles, set.defaultProfile));
+    }
+    if (set.profiles.length === 1 && !set.profiles[0].webBaseUrl)
+        return set.profiles[0];
+    throw new PingCodeError(`没有 profile 的 webBaseUrl 匹配主机 ${host}。请为对应 profile 配置 webBaseUrl，或通过 profile 参数指定。\n` +
+        describeProfiles(set.profiles, set.defaultProfile));
+}
+/** Mask a token for display: keeps only the last 4 characters. */
+export function maskToken(token) {
+    return token.length > 8 ? `***${token.slice(-4)}` : "***";
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { configFilePath, getProfiles } from "./config/index.js";
+import { initConfig, noProfileHint } from "./init.js";
+import { registerAllTools } from "./tools/register.js";
+const { version } = createRequire(import.meta.url)("../package.json");
+const arg = process.argv[2];
+if (arg === "--version" || arg === "-v") {
+    console.log(version);
+    process.exit(0);
+}
+if (arg === "--help" || arg === "-h") {
+    console.log(`pingcode-mcp ${version} — PingCode MCP server (stdio)
+
+Usage:
+  pingcode-mcp                 start the MCP server (run from an MCP client)
+  pingcode-mcp init [--force]  write a config template to the config file
+  pingcode-mcp --version | --help
+
+Configuration (recommended): ${configFilePath().path}
+  { "defaultProfile": "demo",
+    "profiles": [ { "name": "demo", "webBaseUrl": "https://your-tenant.pingcode.com",
+                    "accessToken": "pcpat_...", "defaultSpaceIdentifier": "DEMO" } ] }
+  The MCP client then only needs  "command": "pingcode-mcp"  (no env).
+
+Environment (optional):
+  PINGCODE_CONFIG          config file path override
+  PINGCODE_DEFAULT_PROFILE default profile name override
+  PINGCODE_ACCESS_TOKEN    single token for local development
+                           (+ PINGCODE_API_BASE_URL, PINGCODE_WEB_BASE_URL, PINGCODE_DEFAULT_SPACE)
+  PINGCODE_PROFILES        advanced: profiles JSON, overrides the config file (not recommended in MCP client env)`);
+    process.exit(0);
+}
+if (arg === "init") {
+    const extra = process.argv.slice(3).filter((a) => a !== "--force" && a !== "-f");
+    if (extra.length) {
+        console.error(`pingcode-mcp init: unknown argument(s): ${extra.join(" ")}\nUsage: pingcode-mcp init [--force]`);
+        process.exit(2);
+    }
+    try {
+        const res = initConfig({ force: process.argv.includes("--force") || process.argv.includes("-f") });
+        (res.ok ? console.log : console.error)(res.message);
+        process.exit(res.ok ? 0 : 1);
+    }
+    catch (err) {
+        console.error(`pingcode-mcp init: ${err.message}`);
+        process.exit(1);
+    }
+}
+const server = new McpServer({ name: "pingcode-mcp", version });
+registerAllTools(server);
+// Surface config problems early on stderr (stdout is the MCP channel); tools report them too.
+try {
+    const set = getProfiles();
+    for (const w of set.warnings)
+        console.error(`pingcode-mcp: ${w}`);
+    if (!set.profiles.length)
+        console.error(noProfileHint());
+}
+catch (err) {
+    console.error(`pingcode-mcp: 配置错误: ${err.message}`);
+}
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error(`pingcode-mcp ${version} running on stdio`);
+//# sourceMappingURL=index.js.map

package/dist/init.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import path from "node:path";
+import { configFilePath } from "./config/index.js";
+/** Template written by `pingcode-mcp init` (placeholder token only). */
+export const CONFIG_TEMPLATE = {
+    defaultProfile: "demo",
+    profiles: [
+        {
+            name: "demo",
+            apiBaseUrl: "https://open.pingcode.com",
+            webBaseUrl: "https://your-tenant.pingcode.com",
+            accessToken: "pcpat_REPLACE_ME",
+            defaultSpaceIdentifier: "DEMO",
+        },
+    ],
+};
+export const CONFIG_TEMPLATE_TEXT = JSON.stringify(CONFIG_TEMPLATE, null, 2) + "\n";
+/**
+ * Write the config template to PINGCODE_CONFIG or ~/.config/pingcode-mcp/config.json.
+ * Refuses to overwrite an existing file unless `force` is set.
+ */
+export function initConfig(opts = {}) {
+    const file = configFilePath(opts.env ?? process.env).path;
+    if (fs.existsSync(file) && !opts.force) {
+        return {
+            ok: false,
+            path: file,
+            message: `配置文件已存在: ${file}\n未做任何修改。如需用模板覆盖，请运行: pingcode-mcp init --force`,
+        };
+    }
+    fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(file, CONFIG_TEMPLATE_TEXT, { mode: 0o600 });
+    try {
+        fs.chmodSync(file, 0o600); // mode above only applies to newly created files
+    }
+    catch {
+        // e.g. Windows — ignore
+    }
+    return {
+        ok: true,
+        path: file,
+        message: `已生成配置文件: ${file}
+
+下一步:
+  1. 编辑该文件：把 accessToken 换成你的 PingCode 访问令牌，webBaseUrl 换成租户地址
+     （多个租户就在 profiles 数组里追加条目）
+  2. 限制权限: chmod 600 ${file}
+  3. MCP 客户端只需配置 "command": "pingcode-mcp"（不需要 env），例如:
+       claude mcp add pingcode -- pingcode-mcp
+  4. 验证: 在客户端调用 pingcode_check_auth`,
+    };
+}
+/** Short stderr hint shown once at startup when no profile is configured. */
+export function noProfileHint(env = process.env) {
+    const file = configFilePath(env).path;
+    const minimal = JSON.stringify({ profiles: [{ name: "demo", webBaseUrl: "https://your-tenant.pingcode.com", accessToken: "pcpat_REPLACE_ME" }] }, null, 2);
+    return `pingcode-mcp: 未配置任何 profile。运行 \`pingcode-mcp init\` 生成配置文件，或手动创建 ${file}:
+${minimal}`;
+}
+//# sourceMappingURL=init.js.map