yescms-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,173 @@
+# YESCMS MCP Server
+
+`YESCMS.McpServer` 是给 AI 工具使用的 MCP Server。
+
+它把 YESCMS 的文章发布能力暴露给 Codex、Claude Code、Cursor、opencode 等 MCP 宿主，让 AI 可以读取文章类目、上传文章图片、发布 Markdown 文章。
+
+## 提供的工具
+
+| 工具名 | 作用 |
+|---|---|
+| `yescms_list_categories` | 读取 YESCMS 文章档案类目 |
+| `yescms_upload_article_image` | 上传本地图片到 YESCMS |
+| `yescms_publish_article` | 发布 Markdown 文章到 YESCMS |
+
+## 环境要求
+
+- Node.js 24.16.0
+- npm
+- 可访问的 YESCMS 站点
+- 可用的 AI API Token
+
+进入目录后先切换 Node 版本：
+
+```powershell
+fnm use 24.16.0
+```
+
+## 安装和构建
+
+```powershell
+cd _AITools\YESCMS.McpServer
+fnm use 24.16.0
+npm install
+npm run build
+```
+
+构建结果在：
+
+```text
+_AITools/YESCMS.McpServer/dist/index.js
+_AITools/YESCMS.McpServer/dist/start_fnm.cmd
+```
+
+## npm 打包分发
+
+这个项目可以按 npm 包分发，不需要把源码目录发给使用者。
+
+生成本地安装包：
+
+```powershell
+cd _AITools\YESCMS.McpServer
+fnm use 24.16.0
+npm pack
+```
+
+生成的文件类似：
+
+```text
+yescms-mcp-server-1.0.0.tgz
+```
+
+使用者安装本地包：
+
+```powershell
+npm install -g .\yescms-mcp-server-1.0.0.tgz
+```
+
+如果发布到 npm registry，使用者可以直接运行：
+
+```powershell
+npx -y yescms-mcp-server
+```
+
+包内只包含 `dist` 和 `README.md`。运行依赖会由 npm 自动安装，不需要复制源码，也不需要手动复制 `node_modules`。
+
+## 本地验证
+
+```powershell
+npm run smoke
+```
+
+这个命令只验证 MCP 初始化和工具列表，不会访问 YESCMS，也不会发布文章。
+
+## MCP 宿主配置
+
+### Codex TOML
+
+```toml
+[mcp_servers.yescms]
+command = "npx"
+args = ["-y", "yescms-mcp-server"]
+
+[mcp_servers.yescms.env]
+YESCMS_BASE_URL = "https://www.example.com"
+YESCMS_AI_TOKEN = "yescms_ai_xxx"
+```
+
+如果使用本地 `.tgz` 包，先全局安装，再配置：
+
+```toml
+[mcp_servers.yescms]
+command = "yescms-mcp"
+
+[mcp_servers.yescms.env]
+YESCMS_BASE_URL = "https://www.example.com"
+YESCMS_AI_TOKEN = "yescms_ai_xxx"
+```
+
+### 通用 JSON
+
+```json
+{
+  "mcpServers": {
+    "yescms": {
+      "command": "npx",
+      "args": ["-y", "yescms-mcp-server"],
+      "env": {
+        "YESCMS_BASE_URL": "https://www.example.com",
+        "YESCMS_AI_TOKEN": "yescms_ai_xxx"
+      }
+    }
+  }
+}
+```
+
+## 配置项
+
+| 变量名 | 必填 | 说明 |
+|---|---|---|
+| `YESCMS_BASE_URL` | 是 | YESCMS 网站地址，例如 `https://www.example.com` |
+| `YESCMS_AI_TOKEN` | 否 | 直接传入 Token，最简单 |
+| `YESCMS_AI_TOKEN_FILE` | 否 | 从文件读取 Token |
+| `YESCMS_AI_TOKEN_COMMAND` | 否 | 通过命令读取 Token，值必须是 JSON 字符串数组 |
+| `YESCMS_CREDENTIAL_TARGET` | 否 | Windows Credential Manager 里的凭据名 |
+
+Token 读取顺序：
+
+1. 配置文件里的 Token。
+2. `YESCMS_AI_TOKEN`。
+3. `YESCMS_AI_TOKEN_FILE`。
+4. `YESCMS_AI_TOKEN_COMMAND`。
+5. Windows Credential Manager。
+
+## 配置文件位置
+
+如果没有通过环境变量传入配置，Server 会读取：
+
+```text
+%APPDATA%\YESCMS-MCP\config.json
+```
+
+配置示例：
+
+```json
+{
+  "baseUrl": "https://www.example.com",
+  "credentialTarget": "YESCMS-MCP:AI-API-Token"
+}
+```
+
+## Token 命令格式
+
+`YESCMS_AI_TOKEN_COMMAND` 必须是 JSON 字符串数组：
+
+```powershell
+$env:YESCMS_AI_TOKEN_COMMAND='["powershell.exe","-NoProfile","-Command","Get-Content D:\\token.txt"]'
+```
+
+## 注意事项
+
+- `yescms_publish_article` 会真实发布文章。
+- `yescms_upload_article_image` 会真实上传图片。
+- Windows Credential Manager 只适用于 Windows；Linux/macOS 建议使用 `YESCMS_AI_TOKEN_FILE` 或 `YESCMS_AI_TOKEN_COMMAND`。

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerYescmsTools } from "./tools/yescmsTools.js";
+const server = new McpServer({
+    name: "yescms-mcp",
+    version: "1.0.0"
+});
+registerYescmsTools(server);
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE5B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/shared/appPaths.js

@@ -0,0 +1,16 @@
+import os from "node:os";
+import path from "node:path";
+export const defaultCredentialTarget = "YESCMS-MCP:AI-API-Token";
+export function getAppDataDirectory() {
+    if (process.env.APPDATA) {
+        return path.join(process.env.APPDATA, "YESCMS-MCP");
+    }
+    if (process.env.XDG_CONFIG_HOME) {
+        return path.join(process.env.XDG_CONFIG_HOME, "YESCMS-MCP");
+    }
+    return path.join(os.homedir(), ".config", "YESCMS-MCP");
+}
+export function getConfigPath() {
+    return path.join(getAppDataDirectory(), "config.json");
+}
+//# sourceMappingURL=appPaths.js.map

package/dist/shared/appPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appPaths.js","sourceRoot":"","sources":["../../src/shared/appPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE,MAAM,UAAU,mBAAmB;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC"}

package/dist/shared/configStore.js

@@ -0,0 +1,32 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { defaultCredentialTarget, getAppDataDirectory, getConfigPath } from "./appPaths.js";
+export function createDefaultConfig() {
+    return {
+        baseUrl: "",
+        credentialTarget: defaultCredentialTarget
+    };
+}
+export async function loadConfig() {
+    try {
+        const json = await readFile(getConfigPath(), "utf8");
+        const parsed = JSON.parse(json);
+        return {
+            ...createDefaultConfig(),
+            ...parsed
+        };
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return createDefaultConfig();
+        }
+        throw error;
+    }
+}
+export async function saveConfig(config) {
+    await mkdir(getAppDataDirectory(), { recursive: true });
+    await writeFile(getConfigPath(), `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=configStore.js.map

package/dist/shared/configStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.js","sourceRoot":"","sources":["../../src/shared/configStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG5F,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,OAAO,EAAE,EAAE;QACX,gBAAgB,EAAE,uBAAuB;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0B,CAAC;QACzD,OAAO;YACL,GAAG,mBAAmB,EAAE;YACxB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,mBAAmB,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAoB;IACnD,MAAM,KAAK,CAAC,mBAAmB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC"}

package/dist/shared/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/dist/shared/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/shared/models.ts"],"names":[],"mappings":""}

package/dist/shared/tokenProvider.js

@@ -0,0 +1,138 @@
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+export async function getToken(config) {
+    if (config.accessToken?.trim()) {
+        return config.accessToken.trim();
+    }
+    if (config.tokenFile?.trim()) {
+        return (await readFile(config.tokenFile.trim(), "utf8")).trim();
+    }
+    if (config.tokenCommand?.trim()) {
+        return readFromCommand(config.tokenCommand.trim());
+    }
+    if (process.env.YESCMS_AI_TOKEN?.trim()) {
+        return process.env.YESCMS_AI_TOKEN.trim();
+    }
+    if (process.env.YESCMS_AI_TOKEN_FILE?.trim()) {
+        return (await readFile(process.env.YESCMS_AI_TOKEN_FILE.trim(), "utf8")).trim();
+    }
+    if (process.env.YESCMS_AI_TOKEN_COMMAND?.trim()) {
+        return readFromCommand(process.env.YESCMS_AI_TOKEN_COMMAND.trim());
+    }
+    const credentialToken = await readWindowsCredential(config.credentialTarget);
+    if (credentialToken?.trim()) {
+        return credentialToken.trim();
+    }
+    throw new Error("未找到 AI API Token。请设置 YESCMS_AI_TOKEN、YESCMS_AI_TOKEN_FILE 或 YESCMS_AI_TOKEN_COMMAND；Windows 下也可以设置 YESCMS_CREDENTIAL_TARGET。");
+}
+async function readFromCommand(commandJson) {
+    const command = JSON.parse(commandJson);
+    if (!Array.isArray(command) || command.length === 0 || command.some((item) => typeof item !== "string" || item.trim() === "")) {
+        throw new Error("YESCMS_AI_TOKEN_COMMAND 必须是 JSON 字符串数组。");
+    }
+    return runProcess(command[0], command.slice(1));
+}
+async function readWindowsCredential(target) {
+    if (process.platform !== "win32" || !target.trim()) {
+        return null;
+    }
+    const script = `
+param([string]$Target)
+Add-Type -TypeDefinition @"
+using System;
+using System.Runtime.InteropServices;
+using System.Text;
+
+public static class CredentialReader
+{
+    private const uint CredTypeGeneric = 1;
+
+    [DllImport("advapi32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+    private static extern bool CredRead(string target, uint type, uint reservedFlag, out IntPtr credential);
+
+    [DllImport("advapi32.dll", SetLastError = true)]
+    private static extern void CredFree(IntPtr buffer);
+
+    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
+    private struct NativeCredential
+    {
+        public uint Flags;
+        public uint Type;
+        public string TargetName;
+        public string Comment;
+        public System.Runtime.InteropServices.ComTypes.FILETIME LastWritten;
+        public uint CredentialBlobSize;
+        public IntPtr CredentialBlob;
+        public uint Persist;
+        public uint AttributeCount;
+        public IntPtr Attributes;
+        public string TargetAlias;
+        public string UserName;
+    }
+
+    public static string Read(string target)
+    {
+        if (!CredRead(target, CredTypeGeneric, 0, out var pointer))
+        {
+            return "";
+        }
+
+        try
+        {
+            var credential = Marshal.PtrToStructure<NativeCredential>(pointer);
+            if (credential.CredentialBlob == IntPtr.Zero || credential.CredentialBlobSize == 0)
+            {
+                return "";
+            }
+
+            var bytes = new byte[credential.CredentialBlobSize];
+            Marshal.Copy(credential.CredentialBlob, bytes, 0, bytes.Length);
+            return Encoding.Unicode.GetString(bytes).TrimEnd('\\0');
+        }
+        finally
+        {
+            CredFree(pointer);
+        }
+    }
+}
+"@
+[CredentialReader]::Read($Target)
+`;
+    const stdout = await runProcess("powershell.exe", [
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-Command",
+        script,
+        target
+    ]);
+    return stdout.trim() || null;
+}
+async function runProcess(fileName, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(fileName, args, {
+            windowsHide: true,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve(stdout.trim());
+                return;
+            }
+            reject(new Error(`读取 Token 命令失败：${stderr.trim()}`));
+        });
+    });
+}
+//# sourceMappingURL=tokenProvider.js.map

package/dist/shared/tokenProvider.js.map

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

package/dist/shared/yescmsApiClient.js

@@ -0,0 +1,91 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { getToken } from "./tokenProvider.js";
+export class YescmsApiClient {
+    async publishArticle(config, request) {
+        validateConfig(config);
+        const token = await getToken(config);
+        const response = await fetch(buildUrl(config.baseUrl, "/api/Article/PublishFromAI"), {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${token}`,
+                "Content-Type": "application/json"
+            },
+            body: JSON.stringify(request)
+        });
+        return readResponse(response);
+    }
+    async getArchiveCategories(config) {
+        validateConfig(config);
+        const token = await getToken(config);
+        const response = await fetch(buildUrl(config.baseUrl, "/api/Article/ArchiveCategories"), {
+            headers: {
+                "Authorization": `Bearer ${token}`
+            }
+        });
+        const text = await readResponse(response);
+        const root = JSON.parse(text);
+        const status = readProperty(root, "status") ?? -1;
+        if (status !== 0) {
+            throw new Error(readProperty(root, "message") ?? "档案类目接口请求失败。");
+        }
+        return readProperty(root, "data") ?? {
+            defaultCategory: "",
+            categories: []
+        };
+    }
+    async uploadArticleImage(config, filePath, category, compression) {
+        validateConfig(config);
+        const token = await getToken(config);
+        const query = new URLSearchParams();
+        if (category?.trim()) {
+            query.set("category", category.trim());
+        }
+        if (typeof compression === "boolean") {
+            query.set("compression", String(compression));
+        }
+        const fileBytes = await readFile(filePath);
+        const form = new FormData();
+        form.set("file", new Blob([fileBytes], { type: "application/octet-stream" }), path.basename(filePath));
+        const apiPath = query.size === 0
+            ? "/api/UpLoad/ArticleImage"
+            : `/api/UpLoad/ArticleImage?${query.toString()}`;
+        const response = await fetch(buildUrl(config.baseUrl, apiPath), {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${token}`
+            },
+            body: form
+        });
+        return readResponse(response);
+    }
+}
+function validateConfig(config) {
+    if (!config.baseUrl.trim()) {
+        throw new Error("请先配置 YESCMS 网站地址。");
+    }
+    try {
+        new URL(config.baseUrl);
+    }
+    catch {
+        throw new Error("YESCMS 网站地址格式不正确。");
+    }
+}
+async function readResponse(response) {
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(`YESCMS 请求失败（${response.status}）：${text}`);
+    }
+    return text;
+}
+function buildUrl(baseUrl, apiPath) {
+    return new URL(apiPath.replace(/^\/+/, ""), baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`).toString();
+}
+function readProperty(source, name) {
+    const value = source[name] ?? source[toPascalCase(name)];
+    return value;
+}
+function toPascalCase(value) {
+    return value.length === 0 ? value : `${value[0].toUpperCase()}${value.slice(1)}`;
+}
+//# sourceMappingURL=yescmsApiClient.js.map

package/dist/shared/yescmsApiClient.js.map

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

package/dist/start_fnm.cmd

@@ -0,0 +1,7 @@
+@echo off
+cd /d "%~dp0"
+if exist "%~dp0index.js" (
+  fnm exec --using 24.16.0 node "%~dp0index.js"
+) else (
+  fnm exec --using 24.16.0 node "%~dp0dist\index.js"
+)

package/dist/tools/yescmsTools.js

@@ -0,0 +1,79 @@
+import path from "node:path";
+import { z } from "zod";
+import { loadConfig } from "../shared/configStore.js";
+import { YescmsApiClient } from "../shared/yescmsApiClient.js";
+const apiClient = new YescmsApiClient();
+const uploadImageSchema = z.object({
+    filePath: z.string().min(1).describe("Absolute or workspace-relative local image path."),
+    category: z.string().optional().describe("Optional YESCMS archive category."),
+    compression: z.boolean().optional().describe("Whether the YESCMS upload endpoint should compress the image.")
+});
+const publishArticleSchema = z.object({
+    category: z.string().min(1),
+    title: z.string().min(1),
+    markdown: z.string().min(1),
+    summary: z.string().optional(),
+    seoKeywords: z.array(z.string()).optional(),
+    tagList: z.array(z.string()).optional(),
+    coverImageUrl: z.string().optional(),
+    isPublished: z.boolean().optional(),
+    isTop: z.boolean().optional(),
+    groupID: z.string().optional(),
+    shortTitle: z.string().optional(),
+    linkTitle: z.string().optional(),
+    originUrl: z.string().optional(),
+    imageUrls: z.array(z.string()).optional()
+}).passthrough();
+export function registerYescmsTools(server) {
+    server.registerTool("yescms_list_categories", {
+        description: "List YESCMS CMS article archive categories from /api/Article/ArchiveCategories.",
+        inputSchema: z.object({})
+    }, async () => textResult(await readCategoriesJson()));
+    server.registerTool("yescms_upload_article_image", {
+        description: "Upload a local image file to YESCMS /api/UpLoad/ArticleImage and return the image URL.",
+        inputSchema: uploadImageSchema
+    }, async ({ filePath, category, compression }) => {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        return textResult(prettyJsonOrText(await apiClient.uploadArticleImage(await loadEffectiveConfig(), absolutePath, category, compression)));
+    });
+    server.registerTool("yescms_publish_article", {
+        description: "Publish an AI generated Markdown article through YESCMS /api/Article/PublishFromAI.",
+        inputSchema: publishArticleSchema
+    }, async (request) => textResult(prettyJsonOrText(await apiClient.publishArticle(await loadEffectiveConfig(), request))));
+}
+async function readCategoriesJson() {
+    const categoryConfig = await apiClient.getArchiveCategories(await loadEffectiveConfig());
+    return JSON.stringify({
+        defaultCategory: categoryConfig.defaultCategory,
+        categories: categoryConfig.categories
+    }, null, 2);
+}
+async function loadEffectiveConfig() {
+    const config = await loadConfig();
+    if (process.env.YESCMS_BASE_URL?.trim()) {
+        config.baseUrl = process.env.YESCMS_BASE_URL.trim();
+    }
+    if (process.env.YESCMS_CREDENTIAL_TARGET?.trim()) {
+        config.credentialTarget = process.env.YESCMS_CREDENTIAL_TARGET.trim();
+    }
+    return config;
+}
+function textResult(text) {
+    return {
+        content: [
+            {
+                type: "text",
+                text
+            }
+        ]
+    };
+}
+function prettyJsonOrText(text) {
+    try {
+        return JSON.stringify(JSON.parse(text), null, 2);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=yescmsTools.js.map

package/dist/tools/yescmsTools.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "yescms-mcp-server",
+  "version": "1.0.0",
+  "description": "YESCMS MCP Server for listing categories, uploading article images, and publishing Markdown articles.",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "yescms-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24.16.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node ./scripts/copy-start-script.mjs",
+    "prepack": "npm run build",
+    "pack:local": "npm pack",
+    "start": "node ./dist/index.js",
+    "smoke": "node ./smoke-test.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.3"
+  }
+}