@leeguoo/yapi-mcp 0.2.4 → 0.3.0

package/dist/server.js

@@ -8,6 +8,7 @@ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const zod_1 = require("zod");
 const express_1 = __importDefault(require("express"));
 const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
+const package_json_1 = __importDefault(require("../package.json"));
 const api_1 = require("./services/yapi/api");
 const cache_1 = require("./services/yapi/cache");
 const logger_1 = require("./services/yapi/logger");
@@ -73,21 +74,20 @@ class YapiMcpServer {
     logger;
     authService;
     authMode;
+    toolset;
     sseTransport = null;
     isStdioMode;
-    constructor(yapiBaseUrl, yapiToken, yapiLogLevel = "info", yapiCacheTTL = 10, auth) {
+    constructor(yapiBaseUrl, yapiToken, yapiLogLevel = "info", yapiCacheTTL = 10, auth, http, tools) {
         this.logger = new logger_1.Logger("YapiMCP", yapiLogLevel);
-        this.yapiService = new api_1.YApiService(yapiBaseUrl, yapiToken, yapiLogLevel);
-        this.projectInfoCache = new cache_1.ProjectInfoCache(yapiCacheTTL);
+        this.yapiService = new api_1.YApiService(yapiBaseUrl, yapiToken, yapiLogLevel, { timeoutMs: http?.timeoutMs });
+        this.projectInfoCache = new cache_1.ProjectInfoCache(yapiBaseUrl, yapiCacheTTL, yapiLogLevel);
         this.authMode = auth?.mode ?? (auth?.email && auth?.password ? "global" : "token");
         this.authService =
             this.authMode === "global" && auth?.email && auth?.password
-                ? new auth_1.YApiAuthService(yapiBaseUrl, auth.email, auth.password, yapiLogLevel)
+                ? new auth_1.YApiAuthService(yapiBaseUrl, auth.email, auth.password, yapiLogLevel, { timeoutMs: http?.timeoutMs })
                 : null;
+        this.toolset = tools?.toolset ?? "full";
         if (this.authService) {
-            const cachedTokens = this.authService.loadCachedProjectTokens();
-            this.yapiService.setProjectTokens(cachedTokens, { overwrite: false });
-            this.logger.info(`全局模式已启用：已从本地缓存加载 ${cachedTokens.size} 个项目 token`);
             const cachedCookie = this.authService.getCachedCookieHeader();
             if (cachedCookie) {
                 this.yapiService.setCookieHeader(cachedCookie);
@@ -98,7 +98,7 @@ class YapiMcpServer {
         this.logger.info(`YapiMcpServer初始化，日志级别: ${yapiLogLevel}, 缓存TTL: ${yapiCacheTTL}分钟`);
         this.server = new mcp_js_1.McpServer({
             name: "Yapi MCP Server",
-            version: "0.2.1",
+            version: String(package_json_1.default?.version ?? "0.0.0"),
         });
         this.registerTools();
         if (this.isStdioMode) {
@@ -175,6 +175,7 @@ class YapiMcpServer {
         }
     }
     registerTools() {
+        const isFull = this.toolset === "full";
         const yapiParamItemSchema = zod_1.z
             .object({
             name: zod_1.z.string().describe("参数名"),
@@ -189,16 +190,36 @@ class YapiMcpServer {
             value: zod_1.z.string().optional().describe("Header 值（如 application/json）"),
         })
             .passthrough();
+        const normalizeRequiredString = (value) => String(value ?? "").trim();
+        const normalizeProjectId = (value) => {
+            const s = normalizeRequiredString(value);
+            const m = /(\d+)/.exec(s);
+            return m ? m[1] : s;
+        };
+        const normalizeCatId = (value) => {
+            const s = normalizeRequiredString(value);
+            const m = /^cat_(\d+)$/i.exec(s);
+            return m ? m[1] : s;
+        };
+        const normalizeHttpMethod = (value) => normalizeRequiredString(value).toUpperCase();
+        const normalizeApiPath = (value) => {
+            const raw = String(value ?? "");
+            const compact = raw.replace(/\s+/g, "");
+            if (!compact)
+                return "";
+            return compact.startsWith("/") ? compact : `/${compact}`;
+        };
         const buildInterfaceSaveParams = async (input) => {
             const isUpdate = Boolean(input.id);
             let current = null;
             if (isUpdate) {
-                current = await this.yapiService.getApiInterface(input.projectId, input.id);
+                current = await this.yapiService.getApiInterface(normalizeProjectId(input.projectId), String(input.id));
             }
-            const finalCatid = input.catid ?? (current ? String(current.catid ?? "") : "");
-            const finalTitle = input.title ?? (current ? String(current.title ?? "") : "");
-            const finalPath = input.path ?? (current ? String(current.path ?? "") : "");
-            const finalMethod = input.method ?? (current ? String(current.method ?? "") : "");
+            const finalProjectId = normalizeProjectId(input.projectId);
+            const finalCatid = normalizeCatId(input.catid ?? (current ? String(current.catid ?? "") : ""));
+            const finalTitle = normalizeRequiredString(input.title ?? (current ? String(current.title ?? "") : ""));
+            const finalPath = normalizeApiPath(input.path ?? (current ? String(current.path ?? "") : ""));
+            const finalMethod = normalizeHttpMethod(input.method ?? (current ? String(current.method ?? "") : ""));
             if (!finalCatid)
                 return { ok: false, error: "缺少 catid：新增必填；更新可省略但必须能从原接口读取到" };
             if (!finalTitle)
@@ -208,7 +229,7 @@ class YapiMcpServer {
             if (!finalMethod)
                 return { ok: false, error: "缺少 method：新增必填；更新可省略但必须能从原接口读取到" };
             const params = {
-                project_id: input.projectId,
+                project_id: finalProjectId,
                 catid: finalCatid,
                 title: finalTitle,
                 path: finalPath,
@@ -265,7 +286,7 @@ class YapiMcpServer {
             params.api_opened = input.api_opened ?? (isUpdate ? current?.api_opened : undefined);
             return { ok: true, params, isUpdate };
         };
-        this.server.tool("yapi_update_token", "全局模式：使用用户名/密码登录 YApi，刷新本地缓存的 projectId -> token（用于后续调用开放 API）", {
+        this.server.tool("yapi_update_token", "全局模式：使用用户名/密码登录 YApi，刷新本地登录态 Cookie（并可选刷新项目信息缓存）", {
             forceLogin: zod_1.z.boolean().optional().describe("是否强制重新登录（忽略已缓存的 cookie）"),
         }, async ({ forceLogin }) => {
             try {
@@ -279,9 +300,27 @@ class YapiMcpServer {
                         ],
                     };
                 }
-                const { tokens, groups, projects, cookieHeader } = await this.authService.refreshProjectTokens({ forceLogin });
-                this.yapiService.setProjectTokens(tokens, { overwrite: true });
+                const cookieHeader = await this.authService.getCookieHeaderWithLogin({ forceLogin });
                 this.yapiService.setCookieHeader(cookieHeader);
+                const { groups, projects } = await this.authService.listAccessibleProjects({ forceLogin });
+                projects.forEach((p) => {
+                    const projectId = String(p?._id ?? p?.id ?? "");
+                    if (!projectId)
+                        return;
+                    const groupIdRaw = p?.group_id ?? p?.groupId ?? 0;
+                    const uidRaw = p?.uid ?? 0;
+                    const groupId = Number(groupIdRaw);
+                    const uid = Number(uidRaw);
+                    const info = {
+                        _id: projectId,
+                        name: p?.name || p?.project_name || p?.title || "",
+                        desc: p?.desc || "",
+                        group_id: Number.isFinite(groupId) ? groupId : 0,
+                        uid: Number.isFinite(uid) ? uid : 0,
+                        basepath: p?.basepath || "",
+                    };
+                    this.yapiService.getProjectInfoCache().set(projectId, info);
+                });
                 await this.yapiService.loadAllProjectInfo();
                 this.projectInfoCache.saveToCache(this.yapiService.getProjectInfoCache());
                 await this.yapiService.loadAllCategoryLists();
@@ -289,16 +328,14 @@ class YapiMcpServer {
                     content: [
                         {
                             type: "text",
-                            text: `token 刷新完成：分组 ${groups.length} 个，项目 ${projects.length} 个，已缓存 token ${tokens.size} 个。${tokens.size === 0
-                                ? "（提示：部分 YApi 部署不会在开放 API 返回 token，本工具已尝试从项目设置页抓取；如仍为 0，可能账号权限不足或实例限制展示 token。）"
-                                : ""}`,
+                            text: `登录态刷新完成：分组 ${groups.length} 个，项目 ${projects.length} 个；已更新 Cookie，并刷新项目信息/分类缓存。`,
                         },
                     ],
                 };
             }
             catch (error) {
-                this.logger.error("刷新 token 失败:", error);
-                return { content: [{ type: "text", text: `刷新 token 失败: ${error}` }] };
+                this.logger.error("刷新登录态失败:", error);
+                return { content: [{ type: "text", text: `刷新登录态失败: ${error}` }] };
             }
         });
         this.server.tool("yapi_get_api_desc", "获取YApi中特定接口的详细信息", {
@@ -375,19 +412,21 @@ class YapiMcpServer {
                 return { content: [{ type: "text", text: `搜索项目失败: ${error}` }] };
             }
         });
-        this.server.tool("yapi_interface_get", "获取接口数据（对应 /api/interface/get，返回原始字段）", {
-            projectId: zod_1.z.string().describe("YApi项目ID（用于选择 token）"),
-            apiId: zod_1.z.string().describe("接口ID"),
-        }, async ({ projectId, apiId }) => {
-            try {
-                const apiInterface = await this.yapiService.getApiInterface(projectId, apiId);
-                return { content: [{ type: "text", text: JSON.stringify(apiInterface, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`获取接口数据失败:`, error);
-                return { content: [{ type: "text", text: `获取接口数据失败: ${error}` }] };
-            }
-        });
+        if (isFull) {
+            this.server.tool("yapi_interface_get", "获取接口数据（对应 /api/interface/get，返回原始字段）", {
+                projectId: zod_1.z.string().describe("YApi项目ID（用于选择 token）"),
+                apiId: zod_1.z.string().describe("接口ID"),
+            }, async ({ projectId, apiId }) => {
+                try {
+                    const apiInterface = await this.yapiService.getApiInterface(projectId, apiId);
+                    return { content: [{ type: "text", text: JSON.stringify(apiInterface, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`获取接口数据失败:`, error);
+                    return { content: [{ type: "text", text: `获取接口数据失败: ${error}` }] };
+                }
+            });
+        }
         this.server.tool("yapi_save_api", "新增或更新YApi中的接口信息", {
             projectId: zod_1.z.string().describe("YApi项目ID"),
             catid: zod_1.z.string().optional().describe("接口分类ID；新增接口时必填，更新时可省略（会保留原值）"),
@@ -484,192 +523,194 @@ class YapiMcpServer {
                 return { content: [{ type: "text", text: `新增接口分类失败: ${error}` }] };
             }
         });
-        this.server.tool("yapi_interface_get_cat_menu", "获取菜单列表（对应 /api/interface/getCatMenu）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-        }, async ({ projectId }) => {
-            try {
-                const list = await this.yapiService.getCategoryList(projectId);
-                return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`获取菜单列表失败:`, error);
-                return { content: [{ type: "text", text: `获取菜单列表失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_interface_list", "获取接口列表数据（对应 /api/interface/list）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-            page: zod_1.z.number().optional().describe("页码，默认 1"),
-            limit: zod_1.z.number().optional().describe("每页数量，默认 10"),
-        }, async ({ projectId, page, limit }) => {
-            try {
-                const data = await this.yapiService.listInterfaces(projectId, page ?? 1, limit ?? 10);
-                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`获取接口列表失败:`, error);
-                return { content: [{ type: "text", text: `获取接口列表失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_interface_list_cat", "获取某个分类下接口列表（对应 /api/interface/list_cat）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-            catId: zod_1.z.string().describe("分类ID"),
-            page: zod_1.z.number().optional().describe("页码，默认 1"),
-            limit: zod_1.z.number().optional().describe("每页数量，默认 10"),
-        }, async ({ projectId, catId, page, limit }) => {
-            try {
-                const response = await this.yapiService.listCategoryInterfaces(projectId, catId, page ?? 1, limit ?? 10);
-                return { content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`获取分类接口列表失败:`, error);
-                return { content: [{ type: "text", text: `获取分类接口列表失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_interface_list_menu", "获取接口菜单列表（对应 /api/interface/list_menu）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-        }, async ({ projectId }) => {
-            try {
-                const data = await this.yapiService.getInterfaceMenu(projectId);
-                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`获取接口菜单列表失败:`, error);
-                return { content: [{ type: "text", text: `获取接口菜单列表失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_interface_add", "新增接口（对应 /api/interface/add）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-            catid: zod_1.z.string().describe("接口分类ID"),
-            title: zod_1.z.string().describe("接口标题"),
-            path: zod_1.z.string().describe("接口路径"),
-            method: zod_1.z.string().describe("请求方法"),
-            status: zod_1.z.string().optional().describe("接口状态，默认 undone"),
-            tag: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe("标签"),
-            req_params: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("路径参数"),
-            req_query: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("查询参数"),
-            req_headers: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiHeaderItemSchema)]).optional().describe("请求头"),
-            req_body_type: zod_1.z.string().optional().describe("请求体类型"),
-            req_body_form: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("表单请求体"),
-            req_body_other: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("其他请求体"),
-            req_body_is_json_schema: zod_1.z.boolean().optional().describe("请求体是否 JSON Schema"),
-            res_body_type: zod_1.z.string().optional().describe("响应类型，默认 json"),
-            res_body: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("响应内容"),
-            res_body_is_json_schema: zod_1.z.boolean().optional().describe("响应是否 JSON Schema"),
-            switch_notice: zod_1.z.boolean().optional().describe("是否通知"),
-            api_opened: zod_1.z.boolean().optional().describe("是否公开"),
-            message: zod_1.z.string().optional().describe("接口备注信息"),
-            desc: zod_1.z.string().optional().describe("接口描述"),
-            markdown: zod_1.z.string().optional().describe("markdown 描述"),
-        }, async (input) => {
-            try {
-                const built = await buildInterfaceSaveParams({ ...input, id: undefined });
-                if (!built.ok)
-                    return { content: [{ type: "text", text: built.error }] };
-                const response = await this.yapiService.addInterface(built.params);
-                return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`新增接口失败:`, error);
-                return { content: [{ type: "text", text: `新增接口失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_interface_up", "更新接口（对应 /api/interface/up）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-            id: zod_1.z.string().describe("接口ID"),
-            catid: zod_1.z.string().optional().describe("分类ID（可省略，会保留原值）"),
-            title: zod_1.z.string().optional().describe("接口标题（可省略，会保留原值）"),
-            path: zod_1.z.string().optional().describe("接口路径（可省略，会保留原值）"),
-            method: zod_1.z.string().optional().describe("请求方法（可省略，会保留原值）"),
-            status: zod_1.z.string().optional().describe("接口状态"),
-            tag: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe("标签"),
-            req_params: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("路径参数"),
-            req_query: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("查询参数"),
-            req_headers: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiHeaderItemSchema)]).optional().describe("请求头"),
-            req_body_type: zod_1.z.string().optional().describe("请求体类型"),
-            req_body_form: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("表单请求体"),
-            req_body_other: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("其他请求体"),
-            req_body_is_json_schema: zod_1.z.boolean().optional().describe("请求体是否 JSON Schema"),
-            res_body_type: zod_1.z.string().optional().describe("响应类型"),
-            res_body: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("响应内容"),
-            res_body_is_json_schema: zod_1.z.boolean().optional().describe("响应是否 JSON Schema"),
-            switch_notice: zod_1.z.boolean().optional().describe("是否通知"),
-            api_opened: zod_1.z.boolean().optional().describe("是否公开"),
-            message: zod_1.z.string().optional().describe("接口备注信息"),
-            desc: zod_1.z.string().optional().describe("接口描述"),
-            markdown: zod_1.z.string().optional().describe("markdown 描述"),
-        }, async (input) => {
-            try {
-                const built = await buildInterfaceSaveParams(input);
-                if (!built.ok)
-                    return { content: [{ type: "text", text: built.error }] };
-                const response = await this.yapiService.updateInterface(built.params);
-                return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`更新接口失败:`, error);
-                return { content: [{ type: "text", text: `更新接口失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_interface_save", "新增或者更新接口（对应 /api/interface/save）", {
-            projectId: zod_1.z.string().describe("YApi项目ID"),
-            id: zod_1.z.string().optional().describe("接口ID（有则更新，无则新增）"),
-            catid: zod_1.z.string().optional().describe("接口分类ID"),
-            title: zod_1.z.string().optional().describe("接口标题"),
-            path: zod_1.z.string().optional().describe("接口路径"),
-            method: zod_1.z.string().optional().describe("请求方法"),
-            status: zod_1.z.string().optional().describe("接口状态"),
-            tag: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe("标签"),
-            req_params: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("路径参数"),
-            req_query: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("查询参数"),
-            req_headers: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiHeaderItemSchema)]).optional().describe("请求头"),
-            req_body_type: zod_1.z.string().optional().describe("请求体类型"),
-            req_body_form: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("表单请求体"),
-            req_body_other: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("其他请求体"),
-            req_body_is_json_schema: zod_1.z.boolean().optional().describe("请求体是否 JSON Schema"),
-            res_body_type: zod_1.z.string().optional().describe("响应类型"),
-            res_body: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("响应内容"),
-            res_body_is_json_schema: zod_1.z.boolean().optional().describe("响应是否 JSON Schema"),
-            switch_notice: zod_1.z.boolean().optional().describe("是否通知"),
-            api_opened: zod_1.z.boolean().optional().describe("是否公开"),
-            message: zod_1.z.string().optional().describe("接口备注信息"),
-            desc: zod_1.z.string().optional().describe("接口描述"),
-            markdown: zod_1.z.string().optional().describe("markdown 描述"),
-        }, async (input) => {
-            try {
-                const built = await buildInterfaceSaveParams(input);
-                if (!built.ok)
-                    return { content: [{ type: "text", text: built.error }] };
-                const response = await this.yapiService.saveInterfaceUnified(built.params);
-                return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`保存接口失败:`, error);
-                return { content: [{ type: "text", text: `保存接口失败: ${error}` }] };
-            }
-        });
-        this.server.tool("yapi_open_import_data", "服务端数据导入（对应 /api/open/import_data）", {
-            projectId: zod_1.z.string().describe("YApi项目ID（用于选择 token）"),
-            type: zod_1.z.string().describe("导入方式，如 swagger"),
-            merge: zod_1.z.enum(["normal", "good", "merge"]).describe("同步模式：normal/good/merge"),
-            json: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("导入数据 JSON（会自动序列化为字符串）"),
-            url: zod_1.z.string().optional().describe("导入数据 URL（提供后会走 url 方式）"),
-        }, async ({ projectId, type, merge, json, url }) => {
-            try {
-                let jsonString;
-                if (json !== undefined) {
-                    const normalized = normalizeStringOrJson(json, "json");
-                    if (!normalized.ok)
-                        return { content: [{ type: "text", text: normalized.error }] };
-                    jsonString = normalized.value;
+        if (isFull) {
+            this.server.tool("yapi_interface_get_cat_menu", "获取菜单列表（对应 /api/interface/getCatMenu）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+            }, async ({ projectId }) => {
+                try {
+                    const list = await this.yapiService.getCategoryList(projectId);
+                    return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
                 }
-                const data = await this.yapiService.importData(projectId, { type, merge, json: jsonString, url });
-                return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-            }
-            catch (error) {
-                this.logger.error(`导入数据失败:`, error);
-                return { content: [{ type: "text", text: `导入数据失败: ${error}` }] };
-            }
-        });
+                catch (error) {
+                    this.logger.error(`获取菜单列表失败:`, error);
+                    return { content: [{ type: "text", text: `获取菜单列表失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_interface_list", "获取接口列表数据（对应 /api/interface/list）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+                page: zod_1.z.number().optional().describe("页码，默认 1"),
+                limit: zod_1.z.number().optional().describe("每页数量，默认 10"),
+            }, async ({ projectId, page, limit }) => {
+                try {
+                    const data = await this.yapiService.listInterfaces(projectId, page ?? 1, limit ?? 10);
+                    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`获取接口列表失败:`, error);
+                    return { content: [{ type: "text", text: `获取接口列表失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_interface_list_cat", "获取某个分类下接口列表（对应 /api/interface/list_cat）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+                catId: zod_1.z.string().describe("分类ID"),
+                page: zod_1.z.number().optional().describe("页码，默认 1"),
+                limit: zod_1.z.number().optional().describe("每页数量，默认 10"),
+            }, async ({ projectId, catId, page, limit }) => {
+                try {
+                    const response = await this.yapiService.listCategoryInterfaces(projectId, catId, page ?? 1, limit ?? 10);
+                    return { content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`获取分类接口列表失败:`, error);
+                    return { content: [{ type: "text", text: `获取分类接口列表失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_interface_list_menu", "获取接口菜单列表（对应 /api/interface/list_menu）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+            }, async ({ projectId }) => {
+                try {
+                    const data = await this.yapiService.getInterfaceMenu(projectId);
+                    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`获取接口菜单列表失败:`, error);
+                    return { content: [{ type: "text", text: `获取接口菜单列表失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_interface_add", "新增接口（对应 /api/interface/add）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+                catid: zod_1.z.string().describe("接口分类ID"),
+                title: zod_1.z.string().describe("接口标题"),
+                path: zod_1.z.string().describe("接口路径"),
+                method: zod_1.z.string().describe("请求方法"),
+                status: zod_1.z.string().optional().describe("接口状态，默认 undone"),
+                tag: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe("标签"),
+                req_params: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("路径参数"),
+                req_query: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("查询参数"),
+                req_headers: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiHeaderItemSchema)]).optional().describe("请求头"),
+                req_body_type: zod_1.z.string().optional().describe("请求体类型"),
+                req_body_form: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("表单请求体"),
+                req_body_other: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("其他请求体"),
+                req_body_is_json_schema: zod_1.z.boolean().optional().describe("请求体是否 JSON Schema"),
+                res_body_type: zod_1.z.string().optional().describe("响应类型，默认 json"),
+                res_body: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("响应内容"),
+                res_body_is_json_schema: zod_1.z.boolean().optional().describe("响应是否 JSON Schema"),
+                switch_notice: zod_1.z.boolean().optional().describe("是否通知"),
+                api_opened: zod_1.z.boolean().optional().describe("是否公开"),
+                message: zod_1.z.string().optional().describe("接口备注信息"),
+                desc: zod_1.z.string().optional().describe("接口描述"),
+                markdown: zod_1.z.string().optional().describe("markdown 描述"),
+            }, async (input) => {
+                try {
+                    const built = await buildInterfaceSaveParams({ ...input, id: undefined });
+                    if (!built.ok)
+                        return { content: [{ type: "text", text: built.error }] };
+                    const response = await this.yapiService.addInterface(built.params);
+                    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`新增接口失败:`, error);
+                    return { content: [{ type: "text", text: `新增接口失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_interface_up", "更新接口（对应 /api/interface/up）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+                id: zod_1.z.string().describe("接口ID"),
+                catid: zod_1.z.string().optional().describe("分类ID（可省略，会保留原值）"),
+                title: zod_1.z.string().optional().describe("接口标题（可省略，会保留原值）"),
+                path: zod_1.z.string().optional().describe("接口路径（可省略，会保留原值）"),
+                method: zod_1.z.string().optional().describe("请求方法（可省略，会保留原值）"),
+                status: zod_1.z.string().optional().describe("接口状态"),
+                tag: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe("标签"),
+                req_params: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("路径参数"),
+                req_query: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("查询参数"),
+                req_headers: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiHeaderItemSchema)]).optional().describe("请求头"),
+                req_body_type: zod_1.z.string().optional().describe("请求体类型"),
+                req_body_form: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("表单请求体"),
+                req_body_other: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("其他请求体"),
+                req_body_is_json_schema: zod_1.z.boolean().optional().describe("请求体是否 JSON Schema"),
+                res_body_type: zod_1.z.string().optional().describe("响应类型"),
+                res_body: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("响应内容"),
+                res_body_is_json_schema: zod_1.z.boolean().optional().describe("响应是否 JSON Schema"),
+                switch_notice: zod_1.z.boolean().optional().describe("是否通知"),
+                api_opened: zod_1.z.boolean().optional().describe("是否公开"),
+                message: zod_1.z.string().optional().describe("接口备注信息"),
+                desc: zod_1.z.string().optional().describe("接口描述"),
+                markdown: zod_1.z.string().optional().describe("markdown 描述"),
+            }, async (input) => {
+                try {
+                    const built = await buildInterfaceSaveParams(input);
+                    if (!built.ok)
+                        return { content: [{ type: "text", text: built.error }] };
+                    const response = await this.yapiService.updateInterface(built.params);
+                    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`更新接口失败:`, error);
+                    return { content: [{ type: "text", text: `更新接口失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_interface_save", "新增或者更新接口（对应 /api/interface/save）", {
+                projectId: zod_1.z.string().describe("YApi项目ID"),
+                id: zod_1.z.string().optional().describe("接口ID（有则更新，无则新增）"),
+                catid: zod_1.z.string().optional().describe("接口分类ID"),
+                title: zod_1.z.string().optional().describe("接口标题"),
+                path: zod_1.z.string().optional().describe("接口路径"),
+                method: zod_1.z.string().optional().describe("请求方法"),
+                status: zod_1.z.string().optional().describe("接口状态"),
+                tag: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe("标签"),
+                req_params: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("路径参数"),
+                req_query: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("查询参数"),
+                req_headers: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiHeaderItemSchema)]).optional().describe("请求头"),
+                req_body_type: zod_1.z.string().optional().describe("请求体类型"),
+                req_body_form: zod_1.z.union([zod_1.z.string(), zod_1.z.array(yapiParamItemSchema)]).optional().describe("表单请求体"),
+                req_body_other: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("其他请求体"),
+                req_body_is_json_schema: zod_1.z.boolean().optional().describe("请求体是否 JSON Schema"),
+                res_body_type: zod_1.z.string().optional().describe("响应类型"),
+                res_body: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("响应内容"),
+                res_body_is_json_schema: zod_1.z.boolean().optional().describe("响应是否 JSON Schema"),
+                switch_notice: zod_1.z.boolean().optional().describe("是否通知"),
+                api_opened: zod_1.z.boolean().optional().describe("是否公开"),
+                message: zod_1.z.string().optional().describe("接口备注信息"),
+                desc: zod_1.z.string().optional().describe("接口描述"),
+                markdown: zod_1.z.string().optional().describe("markdown 描述"),
+            }, async (input) => {
+                try {
+                    const built = await buildInterfaceSaveParams(input);
+                    if (!built.ok)
+                        return { content: [{ type: "text", text: built.error }] };
+                    const response = await this.yapiService.saveInterfaceUnified(built.params);
+                    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`保存接口失败:`, error);
+                    return { content: [{ type: "text", text: `保存接口失败: ${error}` }] };
+                }
+            });
+            this.server.tool("yapi_open_import_data", "服务端数据导入（对应 /api/open/import_data）", {
+                projectId: zod_1.z.string().describe("YApi项目ID（用于选择 token）"),
+                type: zod_1.z.string().describe("导入方式，如 swagger"),
+                merge: zod_1.z.enum(["normal", "good", "merge"]).describe("同步模式：normal/good/merge"),
+                json: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.any())]).optional().describe("导入数据 JSON（会自动序列化为字符串）"),
+                url: zod_1.z.string().optional().describe("导入数据 URL（提供后会走 url 方式）"),
+            }, async ({ projectId, type, merge, json, url }) => {
+                try {
+                    let jsonString;
+                    if (json !== undefined) {
+                        const normalized = normalizeStringOrJson(json, "json");
+                        if (!normalized.ok)
+                            return { content: [{ type: "text", text: normalized.error }] };
+                        jsonString = normalized.value;
+                    }
+                    const data = await this.yapiService.importData(projectId, { type, merge, json: jsonString, url });
+                    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+                }
+                catch (error) {
+                    this.logger.error(`导入数据失败:`, error);
+                    return { content: [{ type: "text", text: `导入数据失败: ${error}` }] };
+                }
+            });
+        }
         this.server.tool("yapi_search_apis", "搜索YApi中的接口", {
             projectKeyword: zod_1.z.string().optional().describe("项目关键字，用于过滤项目"),
             nameKeyword: zod_1.z.string().optional().describe("接口名称关键字"),
@@ -775,7 +816,7 @@ class YapiMcpServer {
                             项目描述: p?.desc || "无描述",
                             基础路径: p?.basepath || "/",
                             项目分组ID: p?.group_id ?? p?.groupId ?? "",
-                            已缓存Token: id ? (this.yapiService.hasProjectToken(id) ? "是" : "否") : "否",
+                            鉴权方式: "Cookie（全局模式）",
                         };
                     });
                     return {