MSW Auto

基于 MSW (Mock Service Worker) 的智能自动化 Mock 服务器，配备 Web UI 管理和 AI 生成能力。

特性

• 强大的 Mock 能力 - 基于 MSW，支持 REST、GraphQL 和 WebSocket
• 全局开关控制 - 一键开启/关闭所有 Mock 拦截
• Web UI 管理 - 直观的图形界面管理 Mock 配置
• AI 生成 - 使用 LLM 自动生成 Mock 数据
• 前端代码分析 - 自动分析前端项目中的 API 调用 (axios/fetch/XHR)
• MCP 工具服务 - 提供本地文件操作和 AI 集成工具
• 多 LLM 支持 - 支持 Anthropic、OpenAI 等
• 导入支持 - 支持从 Postman 和 Swagger 导入 API 定义
• 主题切换 - 支持浅色/深色主题，一键切换
• 国际化 - 支持中英文界面
• 请求日志 - 实时记录和查看所有请求
• 版本管理 - 支持 Mock 版本历史和回滚

快速开始

安装

npm install msw-auto
# 或
pnpm add msw-auto

配置 LLM

# 设置 API Key
npx msw-auto setting --apikey YOUR_API_KEY

# 选择提供商 (anthropic, openai, custom)
npx msw-auto setting --provider anthropic

# 切换模型
npx msw-auto model claude-3-5-sonnet-20241022

启动服务

# 启动 Mock 服务器
npx msw-auto server --port 3001

# 启动 Web UI (另一个终端)
npx msw-auto web --port 3000

或使用交互式菜单：

npx msw-auto interactive

在浏览器中打开 http://localhost:3000 访问 Web UI。

使用命令

| 命令 | 描述 | |------|------| | msw-auto init | 初始化 MSW | | msw-auto server | 启动 Mock 服务器 | | msw-auto web | 启动 Web UI | | msw-auto generate | AI 生成 Mock | | msw-auto import | 导入 Postman/Swagger | | msw-auto config | 查看 LLM 配置 | | msw-auto setting | 配置 LLM (--provider, --apikey, --baseurl) | | msw-auto model | 切换 LLM 模型 | | msw-auto interactive | 启动交互式菜单 |

LLM 配置

支持的提供商

| 提供商 | 默认模型 | Base URL | |--------|----------|----------| | Anthropic | claude-3-5-sonnet-20241022 | https://api.anthropic.com | | OpenAI | gpt-4o | https://api.openai.com/v1 | | 自定义 | - | 用户指定 |

配置示例

# Anthropic (Claude)
npx msw-auto setting --provider anthropic --apikey sk-ant-xxx

# OpenAI
npx msw-auto setting --provider openai --apikey sk-xxx

# 自定义 API
npx msw-auto setting --provider custom --baseurl https://api.example.com/v1 --apikey xxx

MCP 服务

MCP Server 提供以下工具，任何支持 MCP 协议的 LLM 都可以调用：

文件操作

| 工具 | 描述 | |------|------| | read_file | 读取文件内容 | | write_file | 写入文件内容 | | list_directory | 列出目录内容 | | create_directory | 创建目录 | | file_exists | 检查文件/目录是否存在 |

项目操作

| 工具 | 描述 | |------|------| | analyze_project | 分析项目发现 API 端点 | | generate_mock | 使用 LLM 生成 Mock 数据 | | start_mock_server | 启动 Mock 服务器 | | list_projects | 列出所有项目 | | get_llm_config | 获取 LLM 配置 | | reload_llm_config | 重新加载 LLM 配置 |

MCP 配置

配置 LLM 使用 MCP 工具：

{
  "mcpServers": {
    "msw-auto": {
      "command": "npx",
      "args": ["msw-auto", "mcp"]
    }
  }
}

Web UI 功能

• 仪表盘 - 查看请求统计、最近请求、全局开关控制
• API 浏览器 - 浏览和搜索所有 Mock API
• Mock 管理 - 创建、编辑、删除和启用/禁用 Mock
• 文档生成 - AI 生成 API 文档，一键复制
• 设置 - 主题、语言和 API 配置

API 接口

全局控制

| 接口 | 方法 | 描述 | |------|------|------| | /api/global-toggle | GET | 获取全局开关状态 | | /api/global-toggle | POST | 设置全局开关 (enabled: boolean) | | /api/stats | GET | 获取统计信息 |

Mock 管理

| 接口 | 方法 | 描述 | |------|------|------| | /api/mocks | GET | 获取所有 Mock | | /api/mocks | POST | 创建 Mock | | /api/mocks/:id | GET | 获取单个 Mock | | /api/mocks/:id | PUT | 更新 Mock | | /api/mocks/:id | DELETE | 删除 Mock | | /api/mocks/:id/toggle | POST | 切换单个 Mock 状态 | | /api/mocks/:id/duplicate | POST | 复制 Mock |

版本管理

| 接口 | 方法 | 描述 | |------|------|------| | /api/mocks/:id/versions | GET | 获取版本历史 | | /api/mocks/:id/versions | POST | 创建版本快照 | | /api/mocks/:id/versions/:version/rollback | POST | 回滚到指定版本 | | /api/mocks/:id/versions/compare | GET | 对比两个版本 |

AI 功能

| 接口 | 方法 | 描述 | |------|------|------| | /api/ai/generate | POST | AI 生成 Mock | | /api/ai/improve/:id | POST | AI 改进 Mock | | /api/ai/docs/:id | POST | AI 生成文档 | | /api/ai/chat | POST | AI 对话 | | /api/ai/status | GET | AI 服务状态 |

导入导出

| 接口 | 方法 | 描述 | |------|------|------| | /api/import/openapi | POST | 导入 OpenAPI | | /api/import/postman | POST | 导入 Postman | | /api/export/openapi | GET | 导出 OpenAPI | | /api/export/postman | GET | 导出 Postman | | /api/export/json | GET | 导出 JSON |

架构

┌─────────────────────────────────────────────────────────────┐
│                        MSW Auto                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│   CLI / Web UI                                              │
│       │                                                      │
│       ├── setting --provider xxx   → 配置 LLM                 │
│       └── interactive             → 交互菜单                   │
│               │                                              │
│               ▼                                              │
│       MCP Server (本地工具服务)                              │
│               │                                              │
│               ├── 文件操作                                    │
│               │   ├── read_file                              │
│               │   ├── write_file                             │
│               │   ├── list_directory                         │
│               │   └── create_directory                      │
│               │                                              │
│               ├── AI 生成                                    │
│               │   └── generate_mock ──► LLM API            │
│               │                                              │
│               └── 项目分析                                    │
│                   └── analyze_project                        │
│                                                              │
└─────────────────────────────────────────────────────────────┘

文档

详细文档请访问 文档页面。

贡献

欢迎提交 Pull Request！请先阅读 贡献指南。

许可证

MIT License - 查看 LICENSE 了解更多。

致谢

• MSW - 核心 Mock 库
• Ant Design - UI 组件库
• Vite - 构建工具
• Anthropic - Claude AI