Anymock

导入导出与 AI 接入

导入导出

入口在我的控制台的「导入导出」页签。面板上半部分是导出,下半部分是导入;导入支持四种来源,用页签切换:

来源内容说明
规则 JSONanymock 导出的那份文件(只贴 rules 数组也认)整份还原:匹配条件、响应序列、数据集绑定都还在,适合备份与迁移
OpenAPI / Swagger接口文档,OpenAPI 3.x 与 Swagger 2.0 都支持,JSON 与 YAML 都可以直接贴路径与方法照搬,响应体优先取 example,没有就按 schema 生成示例数据;Swagger 2.0 的 basePath 会自动拼到路径前
Postman 集合Postman 里集合右键 Export 选 Collection v2.1 得到的文件内容把别人整理好的接口清单变成规则:见下面一节
HAR 抓包浏览器「另存为 HAR」得到的文件内容把真实抓包变成规则:见下面一节

导入分两种方式:merge(追加,默认)与 replace(先清空再导入)。replace 会先删再导,面板里会二次确认,并把将要删掉的范围和条数写清楚;未登录时 replace 直接拒绝(避免一次匿名请求清掉别人的规则)。路径撞车时会自动加后缀(orders-1),不会让整批导入卡在一条冲突上。

内容从哪来

方式什么时候用
粘贴内容文档内容已经在剪贴板里了,直接贴进输入框
本地文件选本机的一个文件。读进来会自动认格式(OpenAPI / Swagger、Postman、HAR、anymock 规则 JSON)并把上面的来源页签切过去,内容还能再改
远程链接只有 Swagger 文档的地址。填上去就行,见下面一节

远程链接导入(含认证)

很多 Swagger、OpenAPI 文档都是挂着的一个 URL,逐个拷贝内容并不现实。选「远程链接」填上地址即可:

  • 文档由服务端去拉取。文档站点基本都不给跨域头,浏览器直连一定会被拦下,所以这一步必须放在服务端;
  • 需要认证时选对应的方式:Bearer Token、Basic 账号 + 口令、自定义请求头(一行一个 X-Api-Key: abc123)。凭据只用于这一次拉取,不保存;
  • 点「拉取预览」可以先把内容取回来看看是不是想要的,再决定导不导;直接点「导入」则服务端拉完立刻导入;
  • 出于安全,指向内网 / 本机 / 云元数据地址(169.254.169.254)、非 http(s) 协议、数据库端口 的请求会被拒绝,重定向也会逐跳重新校验。

按项目导入(把范围收进一层)

导入时可以指定「导入到哪个项目」。选了之后,这次导入的作用范围就只剩那一个项目:

  • 导入的接口全部挂到该项目下,访问路径自动带上项目前缀(前缀 order + 路径 orders → order/orders);
  • replace 只清空这个项目里的接口,项目之外的规则不会被动到;
  • 顺带建出来的数据集也归属同一项目(接口在项目里、数据散在外面同样找不着);
  • 没选项目时按上面的身份范围走。项目不存在或不属于你,会直接报错,而不是默默退回账号范围。

清空之前面板会把范围名 + 准确条数报出来,确认框里也是同一套数字:"清空这 12 条"和"清空 87 条"不是一个量级的决定。

Postman 集合导入

Postman 里对着集合右键 Export,格式选 Collection v2.1(v2.0 也认),把文件内容贴进「Postman 集合」页签即可:

  • 集合里的目录会一层层往下翻,翻到真正的请求为止,不用自己先把目录拆平;
  • 取方法、路径、示例响应的状态码与正文。请求头 / 请求体不导(否则规则会要求带上当时的 token 才命中),响应头只留 Content-Type;
  • 一个请求存了多份示例响应(成功 / 失败 / 边界)时,合并成一条规则的响应序列,按顺序循环返回;
  • 路径里的 :id 与 {{id}} 会换成 {id}——不换的话每个 id 都是一条死路径;开头的 {{baseUrl}} 是域名占位,直接丢掉;
  • 没存示例响应的请求也会建出来,正文先给个 {} 占位,地址立刻能调,内容回头自己填;
  • 路径常带 /api/v1 之类前缀,想去掉就在「去掉路径前缀」里填 /api/v1;
  • 集合自带的变量(根节点 variable 里声明的 {{baseUrl}}、{{tenant}} 之类)会替换成它声明的值,路径变量 {{id}} 不会被误伤。

Postman 动态变量:直接就能用

示例响应里常带着 {{$randomInt}}、{{$randomFullName}}、{{$guid}} 这类写法(官方叫 dynamic variables,一共 118 个)。它们底层就是 fakerjs,而本站的假数据本身 就对齐 fakerjs,所以这里不需要改一个字——导入后原样保留,每次调用照常出随机值:

Postman 写法等价的本站写法
{{$guid}} {{$randomUUID}}{{faker.string.uuid}}
{{$timestamp}} / {{$isoTimestamp}}{{now.unix}} / {{now.iso8601}}
{{$randomInt}}{{faker.number.int(0,1000)}}
{{$randomFullName}} {{$randomEmail}}{{faker.person.fullName}} {{faker.internet.email}}
{{$randomCity}} {{$randomCountry}}{{faker.location.city}} {{faker.location.country}}

几个要说的:图片那一批($randomCatsImage 之类)官方给的是已经停服的 lorempixel.com,这里换成可用的随机图片地址;不认识的 $ 变量原样保留, 不会静默变空。想彻底换成本站写法,导入时带上 convert=1(MCP 的 import_postman 也有这个参数),没有等价写法的会保持不动。

HAR 抓包导入

F12 → Network → 刷新页面 → 右键「另存为 HAR」,把文件内容贴进 HAR 页签即可:

  • 只取请求方法与路径、响应状态码与响应体。请求头 / 请求体不导(否则规则会要求带上当时的 cookie、token 才命中);响应头也不导(HAR 里大半是 Content-Length、Content-Encoding 这类传输层头,照搬反而对不上),Content-Type 单独保留;
  • 同一个「方法 + 路径」抓到多次时,会合并成一条规则的响应序列,按顺序循环返回——正好复现"时好时坏"的接口;
  • 二进制响应体(图片、字体、gzip,HAR 里标了 encoding: base64)跳过;
  • 路径常带 /api/v1 之类前缀,想去掉就在「去掉路径前缀」里填 /api/v1。

范围:普通用户只看自己的

身份导出导入replace 清空
登录用户只导出自己创建的规则归到自己名下、默认私有(挂在自己的命名空间下,不上公开列表)只清自己的规则,碰不到别人的
拥有全部权限的账号全部规则保持原来的可见性与归属清空整站规则
未登录只导出公开规则按匿名规则处理拒绝(403)

AI 接入(让 AI 工具直接操作你的接口)

系统内置了 MCP(Model Context Protocol)服务端,端点固定为 /api/mcp(JSON-RPC 2.0 over HTTP)。配好之后,任意支持 MCP 的 AI 工具(Cursor、Claude Desktop、各种自建 Agent)都能直接帮你建接口、改响应、查调用日志,不用再打开网页。

第一步:生成你的 auth key

登录后在控制台的「AI 接入」页点「生成」,会得到一个以 amk_ 开头的密钥,只在这里出现、随时可以重新生成。重新生成会让旧 key 立即失效;不再使用就点「吊销」。

这个 key 等价于你的登录身份:不要提交到仓库、不要发给别人。丢了重新生成一个即可。

第二步:配到 AI 工具里

{
  "mcpServers": {
    "anymock": {
      "type": "streamable-http",
      "url": "https://anymock.run/api/mcp",
      "headers": { "Authorization": "Bearer amk_xxxxxxxx" }
    }
  }
}

控制台的「AI 接入」页会直接给出填好地址与 key 的完整配置,复制进去就行。认证三选一,都能识别:Authorization: Bearer amk_xxx 请求头、X-Api-Key: amk_xxx 请求头,或 URL 上的 ?key=amk_xxx。

能做什么

工具作用
whoami看看当前 key 是谁、有多少条规则
list_rules / get_rule列出 / 查看自己规则(含完整响应配置)
create_rule / update_rule / delete_rule增删改自己的规则
list_projects / create_project / update_project / delete_project项目的查看、新建、改名改前缀、删除
list_datasets / get_dataset / create_dataset / update_dataset / delete_dataset数据集的全套:列表、看行数据、新建、改数据、删除
list_templates看看有哪些现成模板
duplicate_rule / set_rule_enabled / set_rule_visibility复制一条接口、启用停用、切换公开 / 私有
call_rule真的调一次自己的接口,返回状态码、响应头与响应体(自检用)
recent_logs / get_log查最近的调用记录 / 看某条日志的完整详情(含请求头、响应头、请求体)
my_stats我自己的统计:规则数、公开私有、启用停用、总命中、近 24 小时调用
import_openapi / import_har / import_postman从 OpenAPI 3.x / Swagger 2.0 文档(JSON、YAML 都行)、HAR 抓包或 Postman 集合 v2.x 批量生成接口
template_cheatsheet查模板变量与 Mock.js 语法怎么写(写响应内容前先查它,别猜)

除了工具,还支持 MCP 的 resources 与 prompts:接口、数据集、项目都能当资源直接读(anymock://rule/<id>、anymock://dataset/<编号>、anymock://project/<id>、anymock://cheatsheet/template);另有四个现成提示词(造接口、导入文档、排查调用、写响应体),在支持 prompts 的客户端里可以直接选。

所有工具只能看到并操作你自己的数据:别人的规则、别人的数据集一律不可见,改删别人的会直接拒绝。也就是说,AI 再怎么折腾,也不会碰到别人的接口或全站配置。

没配 key 会怎样

请求 /api/mcp 不带 key 或 key 无效时,会返回 JSON-RPC 错误码 -32001 并提示去生成 key;用浏览器直接 GET 这个地址则会得到一段自述 JSON(端点说明、支持的方法、怎么认证),方便排查连通性。