@mcohenchen/pingcode-mcp 0.0.0-stage → 0.3.2

package/dist/wiki/index.js

@@ -0,0 +1,132 @@
+import { PingCodeError } from "../client/errors.js";
+import { HOST_PREFIX_RE, LONG_ID_RE, SCHEME_RE, decode } from "../client/refs.js";
+/** Parse a page URL (absolute, host/path, or relative path) or a bare short/long id. */
+export function parsePageRef(input) {
+    const s = input.trim();
+    if (!s)
+        throw new PingCodeError("url_or_id 不能为空");
+    let host;
+    let pathname = s;
+    if (SCHEME_RE.test(s) || HOST_PREFIX_RE.test(s)) {
+        try {
+            const u = new URL(SCHEME_RE.test(s) ? s : `https://${s}`);
+            host = u.host.toLowerCase() || undefined;
+            pathname = u.pathname;
+        }
+        catch {
+            throw new PingCodeError(`无法解析 URL: ${input}`);
+        }
+    }
+    else {
+        pathname = s.replace(/[?#].*$/, "");
+    }
+    const m = pathname.match(/\/pages\/([^/?#]+)/);
+    if (m) {
+        const ref = { pageId: decode(m[1]) };
+        if (host)
+            ref.host = host;
+        const sp = pathname.match(/\/spaces\/([^/?#]+)\/pages\//);
+        if (sp) {
+            const space = decode(sp[1]);
+            if (LONG_ID_RE.test(space))
+                ref.spaceId = space;
+            else
+                ref.spaceIdentifier = space;
+        }
+        return ref;
+    }
+    if (!host && /^[A-Za-z0-9_-]+$/.test(s))
+        return { pageId: s };
+    throw new PingCodeError(`无法从输入中解析页面 ID: ${input}`);
+}
+export async function readWikiPage(client, urlOrRef) {
+    const pageRef = typeof urlOrRef === "string" ? parsePageRef(urlOrRef) : urlOrRef;
+    const ref = pageRef.pageId;
+    let page;
+    if (LONG_ID_RE.test(ref)) {
+        page = await client.get(`/v1/wiki/pages/${ref}`).catch(() => undefined);
+    }
+    else {
+        page = await client.get(`/v1/wiki/pages/${encodeURIComponent(ref)}`);
+        if (!page?.id)
+            throw new PingCodeError(`页面 ${ref} 的响应中没有 id 字段`);
+    }
+    const longId = page?.id ?? ref;
+    const content = await client.get(`/v1/wiki/pages/${longId}/content`, { format_type: "markdown" });
+    const markdown = typeof content === "string"
+        ? content
+        : content?.content ?? content?.markdown ?? content?.body ?? JSON.stringify(content);
+    const space = page?.space
+        ? { id: page.space.id, name: page.space.name, identifier: page.space.identifier }
+        : pageRef.spaceIdentifier || pageRef.spaceId
+            ? { id: pageRef.spaceId, identifier: pageRef.spaceIdentifier }
+            : undefined;
+    return {
+        title: page?.name ?? page?.title ?? content?.title,
+        id: longId,
+        short_id: page?.short_id ?? (LONG_ID_RE.test(ref) ? undefined : ref),
+        html_url: page?.html_url,
+        space,
+        markdown,
+    };
+}
+export function listSpaces(client, pageIndex, pageSize) {
+    return client.get("/v1/wiki/spaces", { page_index: pageIndex, page_size: pageSize });
+}
+export function listPages(client, spaceId, pageIndex, pageSize) {
+    return client.get("/v1/wiki/pages", { space_id: spaceId, page_index: pageIndex, page_size: pageSize });
+}
+const SPACE_CACHE_TTL_MS = 5 * 60_000;
+const spaceCache = new WeakMap();
+/** All wiki spaces visible to the client (paged through; cached for a few minutes). */
+export async function listAllSpaces(client, refresh = false) {
+    const hit = spaceCache.get(client);
+    if (hit && !refresh && Date.now() - hit.at < SPACE_CACHE_TTL_MS)
+        return hit.spaces;
+    const pageSize = 100;
+    const spaces = [];
+    for (let pageIndex = 0; pageIndex < 100; pageIndex++) {
+        const res = await listSpaces(client, pageIndex, pageSize);
+        const values = res?.values ?? [];
+        for (const s of values)
+            spaces.push({ id: s.id, name: s.name, identifier: s.identifier });
+        const total = typeof res?.total === "number" ? res.total : undefined;
+        if (values.length < pageSize || (total !== undefined && spaces.length >= total))
+            break;
+    }
+    spaceCache.set(client, { at: Date.now(), spaces });
+    return spaces;
+}
+function findSpace(spaces, ref) {
+    const lower = ref.toLowerCase();
+    return (spaces.find((s) => s.identifier === ref) ??
+        spaces.find((s) => s.identifier?.toLowerCase() === lower) ??
+        (() => {
+            const byName = spaces.filter((s) => s.name === ref);
+            return byName.length === 1 ? byName[0] : undefined;
+        })());
+}
+/**
+ * Resolve a space reference to a space id. A 24-hex id is returned as is; anything else is
+ * matched against space identifiers (case-insensitive, e.g. DEMO), then exact space names.
+ */
+export async function resolveSpaceId(client, spaceRef) {
+    const ref = spaceRef.trim();
+    if (!ref)
+        throw new PingCodeError("空间标识不能为空");
+    if (LONG_ID_RE.test(ref))
+        return ref;
+    let spaces = await listAllSpaces(client);
+    let found = findSpace(spaces, ref);
+    if (!found) {
+        // The cache may predate a newly created space; retry once with fresh data.
+        spaces = await listAllSpaces(client, true);
+        found = findSpace(spaces, ref);
+    }
+    if (!found) {
+        const available = spaces.map((s) => `${s.identifier ?? "?"} (${s.name ?? ""})`).join(", ") || "(无)";
+        throw new PingCodeError(`profile "${client.profile.name}" 下找不到标识为 "${ref}" 的知识库空间。可用空间: ${available}`);
+    }
+    return found.id;
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@mcohenchen/pingcode-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.2",
+  "description": "MCP server for PingCode (wiki, projects, work items, comments, sprints) with multi-tenant profiles",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "pingcode-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/index.js',0o755)\"",
+    "start": "node dist/index.js",
+    "test:unit": "tsx scripts/unit/profiles.ts && tsx scripts/unit/ratelimit.ts && tsx scripts/unit/pjm.ts && tsx scripts/unit/comments.ts",
+    "selftest": "tsx scripts/selftest.ts",
+    "test": "npm run test:unit && npm run selftest",
+    "prepublishOnly": "npm run build && npm run test:unit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "dotenv": "^18.0.9",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  },
+  "files": [
+    "dist/**/*.js",
+    "README.md",
+    ".env.example",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "mcp",
+    "pingcode",
+    "wiki",
+    "project",
+    "work-item",
+    "sprint",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xl495/pingcode-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xl495/pingcode-mcp/issues"
+  },
+  "homepage": "https://github.com/xl495/pingcode-mcp#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}