2.3 KiB

Raw Blame History

MCP Swagger Server(mss)

将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具

🚀 快速开始

环境要求

Node.js ≥ 20.0.0
pnpm ≥ 8.0.0

安装 OpenCode Skill

将项目中的 skill 安装到 OpenCode：

# 方式一：复制 skill 目录
cp -r .opencode/skills/mcp-swagger-server ~/.opencode/skills/

# 方式二：在 opencode 中使用 skill
# 在 opencode 对话中提及相关任务时会自动触发

安装 Node.js 和 pnpm（离线环境）

项目已预下载 Node.js 和 pnpm 工具，放在 tools/ 目录下：

tools/
├── node/
│   ├── node-v20.20.2-win-x64.zip      # Windows Node.js
│   └── node-v20.20.2-linux-x64.tar.xz  # Linux Node.js
└── pnpm/
    ├── pnpm-win-x64.exe                 # Windows pnpm
    └── pnpm-linux-x64                  # Linux pnpm

1. 安装 Node.js

Windows:

双击对应版本的msi文件进行安装

# 验证
node -v

Linux:

# 解压到 /opt/nodejs
sudo tar -xf tools/node/node-v20.20.2-linux-x64.tar.xz -C /opt

# 添加到 PATH
export PATH=/opt/nodejs/node-v20.20.2-linux-x64/bin:$PATH

# 验证
node -v

2. 安装 pnpm

Windows:

# 将 pnpm.exe 拷贝到 Node.js 安装目录
copy tools\pnpm\pnpm-win-x64.exe C:\nodejs\node-v20.20.2-win-x64\pnpm.exe

# 验证
C:\nodejs\node-v20.20.2-win-x64\pnpm.exe -v

Linux:

# 拷贝到 /usr/local/bin
sudo cp tools/pnpm/pnpm-linux-x64 /usr/local/bin/pnpm
sudo chmod +x /usr/local/bin/pnpm

# 验证
pnpm -v

安装步骤

前往发行版（release）界面，下载docker镜像

🤖 OpenCode SKILL 使用流程

手动配置 OpenCode MCP

MCP Server 启动后会输出 OpenCode MCP 配置，程序会自动检测配置文件位置并生成完整配置。

配置输出示例：

📁 配置文件路径: C:\Users\xxx\.config\opencode\opencode.json

请将以下配置复制到上述配置文件中（可覆盖原有内容）:

{
  "mcpServers": {
    "localhost-3000": {
      "command": "node",
      "args": [
        "C:\\path\\to\\cli.js",
        "--transport",
        "stdio",
        "--openapi",
        "http://localhost:3000/api-docs.json"
      ]
    }
  }
}

2.3 KiB Raw Blame History Unescape Escape