@leeguoo/yapi-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Graham Lipsman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,328 @@
+# Yapi Auto MCP Server
+
+一个用于 YApi 的 Model Context Protocol (MCP) 服务器，让你能够在 Cursor 等 AI 编程工具中直接操作 YApi 接口文档。
+
+## 项目简介
+
+Yapi Auto MCP Server 是一个基于 [Model Context Protocol](https://modelcontextprotocol.io/) 的服务器，专为 YApi 接口管理平台设计。它允许你在 Cursor、Claude Desktop 等支持 MCP 的 AI 工具中直接：
+
+- 🔍 **搜索和查看** YApi 项目中的接口文档
+- ✏️ **创建和更新** 接口定义
+- 📋 **管理项目和分类** 结构
+- 🔗 **无缝集成** AI 编程工作流
+- 🛠 **支持多个 YApi Project配置**
+
+通过 MCP 协议，AI 助手可以理解你的 YApi 接口结构，在编程过程中提供更准确的建议和代码生成。
+
+## 主要功能
+
+### 🔍 接口查询和搜索
+
+- **yapi_search_apis**: 按名称、路径、标签等条件搜索接口
+- **yapi_get_api_desc**: 获取特定接口的详细信息（请求/响应结构、参数等）
+- **yapi_interface_get**: 获取接口原始数据（对应 `/api/interface/get`）
+- **yapi_interface_list**: 获取接口列表（对应 `/api/interface/list`）
+- **yapi_interface_list_cat**: 获取分类下接口列表（对应 `/api/interface/list_cat`）
+- **yapi_interface_list_menu**: 获取接口菜单列表（对应 `/api/interface/list_menu`）
+- **yapi_list_projects**: 列出所有可访问的项目
+- **yapi_project_get**: 获取项目详情（对应 `/api/project/get`）
+- **yapi_get_categories**: 获取项目下的接口分类和接口列表（支持只返回分类/或包含接口列表）
+- **yapi_interface_get_cat_menu**: 获取分类菜单（对应 `/api/interface/getCatMenu`）
+- **yapi_update_token**: 全局模式登录并刷新本地项目 token 缓存（只需配置一次账号密码）
+
+### ✏️ 接口管理
+
+- **yapi_save_api**: 创建新接口或更新现有接口
+  - 支持完整的接口定义（路径、方法、参数、请求体、响应等）
+  - 支持 JSON Schema 和表单数据格式
+  - 自动处理接口状态和分类管理
+  - 建议把「枚举值/中文备注/示例」优先写在 `req_params` / `req_query` / `req_headers` / `req_body_*` / `res_body`，`desc` 只写一句话简介；更新接口时未提供的字段会尽量保留原值
+- **yapi_interface_add**: 新增接口（对应 `/api/interface/add`）
+- **yapi_interface_up**: 更新接口（对应 `/api/interface/up`）
+- **yapi_interface_save**: 新增或更新接口（对应 `/api/interface/save`）
+- **yapi_interface_add_cat**: 新增接口分类（对应 `/api/interface/add_cat`）
+- **yapi_open_import_data**: 服务端数据导入（对应 `/api/open/import_data`）
+
+### 🎯 智能特性
+
+- **多项目支持**: 同时管理多个 YApi 项目
+- **缓存机制**: 提高查询响应速度
+- **详细日志**: 便于调试和监控
+- **灵活配置**: 支持环境变量和命令行参数
+
+## 快速开始
+
+### 推荐方式：用 Cross Request Master 一键生成 MCP 配置（免手动找 Token）
+
+如果你日常就在浏览器里使用 YApi，推荐安装 Chrome 扩展 [cross-request-master](https://github.com/leeguooooo/cross-request-master)。它会在 YApi 接口详情页（基本信息区域右上角）提供 **「当前项目 MCP 配置」** / **「所有项目 MCP 配置」** 按钮，可一键生成并复制配置：
+
+- 当前项目：使用 `--yapi-token=projectId:token`
+- 整个项目（全局模式）：使用 `--yapi-auth-mode=global`（账号密码），启动后再调用一次 `yapi_update_token` 自动缓存所有项目 token
+
+### 手动方式：使用 npx（无需安装）
+
+你可以选择两种模式：
+
+1) **项目 Token 模式**（与 Cross Request Master 的一键配置一致）
+
+```json
+{
+  "mcpServers": {
+    "yapi-auto-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@leeguoo/yapi-mcp",
+        "--stdio",
+        "--yapi-base-url=https://your-yapi-domain.com",
+        "--yapi-token=projectId:your_token_here"
+      ]
+    }
+  }
+}
+```
+
+2) **全局模式**（只配置一次账号密码，项目 token 自动本地缓存）
+
+```json
+{
+  "mcpServers": {
+    "yapi-auto-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@leeguoo/yapi-mcp",
+        "--stdio",
+        "--yapi-base-url=https://your-yapi-domain.com",
+        "--yapi-auth-mode=global",
+        "--yapi-email=your_email@example.com",
+        "--yapi-password=your_password"
+      ]
+    }
+  }
+}
+```
+
+启动后先在对话里调用一次 `yapi_update_token`，会把 `projectId -> token` 缓存到本地 `~/.yapi-mcp/auth-*.json`，后续所有工具就都能直接使用了。
+
+## 安装配置
+
+### 方式一：npx 直接使用（推荐）
+
+无需本地安装，通过 npx 直接运行：
+
+```json
+{
+  "mcpServers": {
+    "yapi-auto-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@leeguoo/yapi-mcp",
+        "--stdio",
+        "--yapi-base-url=https://yapi.example.com",
+        "--yapi-token=projectId:token1,projectId2:token2",
+        "--yapi-cache-ttl=10",
+        "--yapi-log-level=info"
+      ]
+    }
+  }
+}
+```
+
+### 方式二：使用环境变量
+
+在 MCP 配置中定义环境变量：
+
+```json
+{
+  "mcpServers": {
+    "yapi-auto-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@leeguoo/yapi-mcp",
+        "--stdio"
+      ],
+      "env": {
+        "YAPI_BASE_URL": "https://yapi.example.com",
+        "YAPI_TOKEN": "projectId:token1,projectId2:token2",
+        "YAPI_AUTH_MODE": "token",
+        "YAPI_CACHE_TTL": "10",
+        "YAPI_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+全局模式对应环境变量（更适合“只配置一次”）：
+
+```json
+{
+  "mcpServers": {
+    "yapi-auto-mcp": {
+      "command": "npx",
+      "args": ["-y", "@leeguoo/yapi-mcp", "--stdio"],
+      "env": {
+        "YAPI_BASE_URL": "https://yapi.example.com",
+        "YAPI_AUTH_MODE": "global",
+        "YAPI_EMAIL": "your_email@example.com",
+        "YAPI_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+### 方式三：本地开发模式
+
+适合需要修改代码或调试的场景：
+
+1. **克隆和安装**：
+
+```bash
+git clone <repository-url>
+cd yapi-mcp
+pnpm install
+```
+
+2. **配置环境变量**（在项目根目录创建 `.env` 文件）：
+
+```env
+# YApi 基础配置
+YAPI_BASE_URL=https://your-yapi-domain.com
+YAPI_TOKEN=projectId:your_token_here,projectId2:your_token2_here
+
+# 服务器配置
+PORT=3388
+
+# 可选配置
+YAPI_CACHE_TTL=10
+YAPI_LOG_LEVEL=info
+```
+
+3. **启动服务**：
+
+**SSE 模式**（HTTP 服务）：
+
+```bash
+pnpm run dev
+```
+
+然后在 Cursor 中配置：
+
+```json
+{
+  "mcpServers": {
+    "yapi-mcp": {
+      "url": "http://localhost:3388/sse"
+    }
+  }
+}
+```
+
+**Stdio 模式**：
+
+```bash
+pnpm run build
+node dist/cli.js --stdio
+```
+
+## 使用指南
+
+### 获取 YApi Token
+
+如果你使用的是 **全局模式**（`--yapi-auth-mode=global` / `YAPI_AUTH_MODE=global`），可以不手动找项目 token：启动后在对话里调用一次 `yapi_update_token`，会自动登录并把所有可访问项目的 `projectId -> token` 缓存到本地。
+
+1. 登录你的 YApi 平台
+2. 进入项目设置页面
+3. 在 Token 配置中生成或查看 Token
+
+不想手动找 Token 的话，可以用 [cross-request-master](https://github.com/leeguooooo/cross-request-master) 在接口详情页一键生成 MCP 配置（会自动带上 `projectId:token`）。
+
+![Token 获取示例](./images/token.png)
+
+Token 格式说明：
+
+- 单项目：`projectId:token`
+- 多项目：`projectId1:token1,projectId2:token2`
+
+### 使用示例
+
+配置完成后，你可以在 Cursor 中这样使用：
+
+![使用示例](./images/demo1.png)
+
+**常用操作示例**：
+
+1. **搜索接口**：
+
+   > "帮我找一下用户登录相关的接口"
+
+2. **查看接口详情**：
+
+   > "显示用户注册接口的详细信息"
+
+3. **创建新接口**：
+
+   > "帮我创建一个获取用户列表的接口，路径是 /api/users，使用 GET 方法"
+
+4. **更新接口**：
+   > "更新用户登录接口，添加验证码参数"
+
+## 高级配置
+
+### 命令行参数详解
+
+| 参数               | 描述                          | 示例                                       | 默认值 |
+| ------------------ | ----------------------------- | ------------------------------------------ | ------ |
+| `--yapi-base-url`  | YApi 服务器基础 URL           | `--yapi-base-url=https://yapi.example.com` | -      |
+| `--yapi-token`     | YApi 项目 Token（支持多项目） | `--yapi-token=1026:token1,1027:token2`     | -      |
+| `--yapi-auth-mode` | 鉴权模式：`token` 或 `global` | `--yapi-auth-mode=global`                  | token  |
+| `--yapi-email`     | 全局模式登录邮箱              | `--yapi-email=a@b.com`                     | -      |
+| `--yapi-password`  | 全局模式登录密码              | `--yapi-password=******`                   | -      |
+| `--yapi-cache-ttl` | 缓存时效（分钟）              | `--yapi-cache-ttl=10`                      | 10     |
+| `--yapi-log-level` | 日志级别                      | `--yapi-log-level=info`                    | info   |
+| `--port`           | HTTP 服务端口（SSE 模式）     | `--port=3388`                              | 3388   |
+| `--stdio`          | 启用 stdio 模式（MCP 必需）   | `--stdio`                                  | -      |
+
+### 环境变量说明
+
+创建 `.env` 文件进行配置：
+
+```env
+# 必需配置
+YAPI_BASE_URL=https://your-yapi-domain.com
+
+# 模式一：项目 Token 模式
+YAPI_AUTH_MODE=token
+YAPI_TOKEN=projectId:your_token_here
+
+# 模式二：全局模式（只配置一次账号密码，启动后调用 yapi_update_token 缓存项目 token）
+# YAPI_AUTH_MODE=global
+# YAPI_EMAIL=your_email@example.com
+# YAPI_PASSWORD=your_password
+
+# 可选配置
+PORT=3388                    # HTTP 服务端口
+YAPI_CACHE_TTL=10           # 缓存时效（分钟）
+YAPI_LOG_LEVEL=info         # 日志级别：debug, info, warn, error, none
+```
+
+### 日志级别说明
+
+- **debug**: 输出所有日志，包括详细的调试信息
+- **info**: 输出信息、警告和错误日志（默认）
+- **warn**: 只输出警告和错误日志
+- **error**: 只输出错误日志
+- **none**: 不输出任何日志
+
+### 配置方式选择建议
+
+| 使用场景 | 推荐方式              | 优势               |
+| -------- | --------------------- | ------------------ |
+| 日常使用 | npx + 命令行参数      | 无需安装，配置简单 |
+| 团队共享 | npx + 环境变量        | 配置统一，易于管理 |
+| 开发调试 | 本地安装 + SSE 模式   | 便于调试和修改代码 |
+| 企业部署 | 本地安装 + stdio 模式 | 性能更好，更稳定   |

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = require("path");
+const dotenv_1 = require("dotenv");
+const index_1 = require("./index");
+(0, dotenv_1.config)({ path: (0, path_1.resolve)(process.cwd(), ".env") });
+(0, index_1.startServer)().catch((error) => {
+    if (error instanceof Error) {
+        console.error("Failed to start server:", error.message);
+    }
+    else {
+        console.error("Failed to start server with unknown error:", error);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,+BAA+B;AAC/B,mCAAgC;AAChC,mCAAsC;AAGtC,IAAA,eAAM,EAAC,EAAE,IAAI,EAAE,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjD,IAAA,mBAAW,GAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACrC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+interface ServerConfig {
+    yapiBaseUrl: string;
+    yapiToken: string;
+    yapiAuthMode: "token" | "global";
+    yapiEmail: string;
+    yapiPassword: string;
+    port: number;
+    yapiCacheTTL: number;
+    yapiLogLevel: string;
+    configSources: {
+        yapiBaseUrl: "cli" | "env" | "default";
+        yapiToken: "cli" | "env" | "default";
+        yapiAuthMode: "cli" | "env" | "default";
+        yapiEmail: "cli" | "env" | "default";
+        yapiPassword: "cli" | "env" | "default";
+        port: "cli" | "env" | "default";
+        yapiCacheTTL: "cli" | "env" | "default";
+        yapiLogLevel: "cli" | "env" | "default";
+    };
+}
+export declare function getServerConfig(): ServerConfig;
+export {};

package/dist/config.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServerConfig = getServerConfig;
+const dotenv_1 = require("dotenv");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const logger_1 = require("./services/yapi/logger");
+(0, dotenv_1.config)();
+function maskApiKey(key) {
+    if (key.length <= 4)
+        return "****";
+    return `****${key.slice(-4)}`;
+}
+function maskSecret(value) {
+    if (!value)
+        return "";
+    if (value.length <= 2)
+        return "**";
+    return `${value[0]}***${value[value.length - 1]}`;
+}
+function getServerConfig() {
+    const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .options({
+        "yapi-base-url": {
+            type: "string",
+            description: "YApi服务器基础URL",
+        },
+        "yapi-token": {
+            type: "string",
+            description: "YApi服务器授权Token",
+        },
+        "yapi-auth-mode": {
+            type: "string",
+            description: "鉴权模式：token=项目 token；global=用户名/密码登录并缓存项目 token",
+            choices: ["token", "global"],
+        },
+        "yapi-email": {
+            type: "string",
+            description: "全局模式登录邮箱（/api/user/login 的 email 字段）",
+        },
+        "yapi-password": {
+            type: "string",
+            description: "全局模式登录密码（/api/user/login 的 password 字段）",
+        },
+        port: {
+            type: "number",
+            description: "Port to run the server on",
+        },
+        "yapi-cache-ttl": {
+            type: "number",
+            description: "YApi缓存有效期（分钟），默认10分钟",
+        },
+        "yapi-log-level": {
+            type: "string",
+            description: "YApi日志级别 (debug, info, warn, error)",
+            choices: ["debug", "info", "warn", "error"],
+        },
+    })
+        .help()
+        .parseSync();
+    const config = {
+        yapiBaseUrl: "http://localhost:3000",
+        yapiToken: "",
+        yapiAuthMode: "token",
+        yapiEmail: "",
+        yapiPassword: "",
+        port: 3388,
+        yapiCacheTTL: 10,
+        yapiLogLevel: "info",
+        configSources: {
+            yapiBaseUrl: "default",
+            yapiToken: "default",
+            yapiAuthMode: "default",
+            yapiEmail: "default",
+            yapiPassword: "default",
+            port: "default",
+            yapiCacheTTL: "default",
+            yapiLogLevel: "default",
+        },
+    };
+    if (argv["yapi-base-url"]) {
+        config.yapiBaseUrl = argv["yapi-base-url"];
+        config.configSources.yapiBaseUrl = "cli";
+    }
+    else if (process.env.YAPI_BASE_URL) {
+        config.yapiBaseUrl = process.env.YAPI_BASE_URL;
+        config.configSources.yapiBaseUrl = "env";
+    }
+    if (argv["yapi-token"]) {
+        config.yapiToken = argv["yapi-token"];
+        config.configSources.yapiToken = "cli";
+    }
+    else if (process.env.YAPI_TOKEN) {
+        config.yapiToken = process.env.YAPI_TOKEN;
+        config.configSources.yapiToken = "env";
+    }
+    if (argv["yapi-email"]) {
+        config.yapiEmail = argv["yapi-email"];
+        config.configSources.yapiEmail = "cli";
+    }
+    else if (process.env.YAPI_EMAIL) {
+        config.yapiEmail = process.env.YAPI_EMAIL;
+        config.configSources.yapiEmail = "env";
+    }
+    if (argv["yapi-password"]) {
+        config.yapiPassword = argv["yapi-password"];
+        config.configSources.yapiPassword = "cli";
+    }
+    else if (process.env.YAPI_PASSWORD) {
+        config.yapiPassword = process.env.YAPI_PASSWORD;
+        config.configSources.yapiPassword = "env";
+    }
+    if (argv["yapi-auth-mode"]) {
+        config.yapiAuthMode = argv["yapi-auth-mode"];
+        config.configSources.yapiAuthMode = "cli";
+    }
+    else if (process.env.YAPI_AUTH_MODE) {
+        const mode = process.env.YAPI_AUTH_MODE.toLowerCase();
+        if (mode === "token" || mode === "global") {
+            config.yapiAuthMode = mode;
+            config.configSources.yapiAuthMode = "env";
+        }
+    }
+    else {
+        config.yapiAuthMode = config.yapiToken ? "token" : config.yapiEmail && config.yapiPassword ? "global" : "token";
+    }
+    if (argv.port) {
+        config.port = argv.port;
+        config.configSources.port = "cli";
+    }
+    else if (process.env.PORT) {
+        config.port = parseInt(process.env.PORT, 10);
+        config.configSources.port = "env";
+    }
+    if (argv["yapi-cache-ttl"]) {
+        config.yapiCacheTTL = argv["yapi-cache-ttl"];
+        config.configSources.yapiCacheTTL = "cli";
+    }
+    else if (process.env.YAPI_CACHE_TTL) {
+        const cacheTTL = parseInt(process.env.YAPI_CACHE_TTL, 10);
+        if (!isNaN(cacheTTL)) {
+            config.yapiCacheTTL = cacheTTL;
+            config.configSources.yapiCacheTTL = "env";
+        }
+    }
+    if (argv["yapi-log-level"]) {
+        config.yapiLogLevel = argv["yapi-log-level"];
+        config.configSources.yapiLogLevel = "cli";
+    }
+    else if (process.env.YAPI_LOG_LEVEL) {
+        const validLevels = ["debug", "info", "warn", "error"];
+        const logLevel = process.env.YAPI_LOG_LEVEL.toLowerCase();
+        if (validLevels.includes(logLevel)) {
+            config.yapiLogLevel = logLevel;
+            config.configSources.yapiLogLevel = "env";
+        }
+    }
+    const logger = new logger_1.Logger("Config", config.yapiLogLevel);
+    logger.info("\nConfiguration:");
+    logger.info(`- YAPI_BASE_URL: ${config.yapiBaseUrl} (source: ${config.configSources.yapiBaseUrl})`);
+    logger.info(`- YAPI_TOKEN: ${config.yapiToken ? maskApiKey(config.yapiToken) : "未配置"} (source: ${config.configSources.yapiToken})`);
+    logger.info(`- YAPI_AUTH_MODE: ${config.yapiAuthMode} (source: ${config.configSources.yapiAuthMode})`);
+    logger.info(`- YAPI_EMAIL: ${config.yapiEmail || "未配置"} (source: ${config.configSources.yapiEmail})`);
+    logger.info(`- YAPI_PASSWORD: ${config.yapiPassword ? maskSecret(config.yapiPassword) : "未配置"} (source: ${config.configSources.yapiPassword})`);
+    logger.info(`- PORT: ${config.port} (source: ${config.configSources.port})`);
+    logger.info(`- YAPI_CACHE_TTL: ${config.yapiCacheTTL} 分钟 (source: ${config.configSources.yapiCacheTTL})`);
+    logger.info(`- YAPI_LOG_LEVEL: ${config.yapiLogLevel} (source: ${config.configSources.yapiLogLevel})`);
+    logger.info("");
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./services/yapi/types";
+export * from "./services/yapi/api";
+export * from "./services/yapi/cache";
+export * from "./services/yapi/logger";
+export declare function startServer(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = startServer;
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("./server");
+const config_1 = require("./config");
+const logger_1 = require("./services/yapi/logger");
+__exportStar(require("./services/yapi/types"), exports);
+__exportStar(require("./services/yapi/api"), exports);
+__exportStar(require("./services/yapi/cache"), exports);
+__exportStar(require("./services/yapi/logger"), exports);
+async function startServer() {
+    const config = (0, config_1.getServerConfig)();
+    const logger = new logger_1.Logger("StartServer", config.yapiLogLevel);
+    const server = new server_1.YapiMcpServer(config.yapiBaseUrl, config.yapiToken, config.yapiLogLevel, config.yapiCacheTTL, {
+        mode: config.yapiAuthMode,
+        email: config.yapiEmail,
+        password: config.yapiPassword,
+    });
+    const isStdioMode = process.env.NODE_ENV === "cli" || process.argv.includes("--stdio");
+    if (isStdioMode) {
+        logger.info("Initializing Yapi MCP Server in stdio mode...");
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+    }
+    else {
+        logger.info(`Initializing Yapi MCP Server in HTTP mode on port ${config.port}...`);
+        await server.startHttpServer(config.port);
+    }
+    logger.info("\n可用工具:");
+    logger.info("- yapi_get_api_desc: 获取YApi接口信息");
+    logger.info("- yapi_save_api: 新增或更新YApi接口");
+    logger.info("- yapi_search_apis: 搜索YApi接口");
+    logger.info("- yapi_list_projects: 列出YApi的项目ID和项目名称");
+    logger.info("- yapi_get_categories: 获取YApi项目下的接口分类列表");
+    logger.info("- yapi_update_token: 全局模式登录并刷新本地 token 缓存");
+}
+if (require.main === module) {
+    startServer().catch((error) => {
+        console.error("Failed to start server:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,kCAsCC;AAjDD,wEAAiF;AACjF,qCAAyC;AACzC,qCAA2C;AAC3C,mDAAgD;AAGhD,wDAAsC;AACtC,sDAAoC;AACpC,wDAAsC;AACtC,yDAAuC;AAEhC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,IAAA,wBAAe,GAAE,CAAC;IAGjC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAG9D,MAAM,MAAM,GAAG,IAAI,sBAAa,CAC9B,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,YAAY,EACnB;QACE,IAAI,EAAE,MAAM,CAAC,YAAY;QACzB,KAAK,EAAE,MAAM,CAAC,SAAS;QACvB,QAAQ,EAAE,MAAM,CAAC,YAAY;KAC9B,CACF,CAAC;IAGF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEvF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,qDAAqD,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;QACnF,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACtD,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;AAC3D,CAAC;AAGD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+export declare class YapiMcpServer {
+    private readonly server;
+    private readonly yapiService;
+    private readonly projectInfoCache;
+    private readonly logger;
+    private readonly authService;
+    private readonly authMode;
+    private sseTransport;
+    private readonly isStdioMode;
+    constructor(yapiBaseUrl: string, yapiToken: string, yapiLogLevel?: string, yapiCacheTTL?: number, auth?: {
+        mode?: "token" | "global";
+        email?: string;
+        password?: string;
+    });
+    private initializeCache;
+    private asyncUpdateCache;
+    private registerTools;
+    connect(transport: Transport): Promise<void>;
+    startHttpServer(port: number): Promise<void>;
+}