简体中文

English

简体中文

English

Appearance

AI 工具调用说明 ​

在 Cursor、Claude Desktop、VS Code 等 AI 工具中开发时，在 你的业务项目 里添加 MCP 配置，由 Agent 学习。

1. 我们提供什么 / 你需要做什么 ​

角色内容
开放平台（我们）在线文档站、llms.txt、MCP 配置示例、官方 Skill
你（以 Cursor 为例）确认配置位置与目录结构 → 添加 .cursor/mcp.json → 在设置中启用 mos-developer-docs → 验证 → 添加 Skill
你的业务项目                         开放平台
──────────                          ─────────
.cursor/mcp.json          ──MCP──►  https://developer.mosapp.app/llms.txt
.cursor/skills/                      https://developer.mosapp.app/zh/guide/sdk.html 等
  mos-developer-docs/SKILL.md

2. MCP配置（以 Cursor 为例） ​

2.1 配置位置（Cursor） ​

添加 MCP 配置前，先确认文件放在哪里：

说明路径
项目级 MCP（推荐）业务项目根目录 .cursor/mcp.json
全局 MCP（所有项目生效）~/.cursor/mcp.json

在 Cursor 中可通过 Settings → Plugins → Tools & MCPs 查看 MCP 状态；配置文件即上述 .cursor/mcp.json。

2.2 推荐的项目目录结构 ​

在对应路径下按如下结构准备（下一步将在 .cursor/mcp.json 写入 MCP 配置）：

text
your-miniapp-project/
├── src/
└── .cursor/
    ├── mcp.json                 # 必做：MCP 配置
    └── skills/
        └── mos-developer-docs/
            └── SKILL.md         # 见下文 Skill配置

2.3 添加 MCP 配置 ​

Node.js 版本

说明要求
使用下方官方示例（锁定 [email protected]）Node 18+
若自行改为最新版 mcp-fetch-server（未锁版本）建议 20.19+、22.12+ 或 24+（依赖 jsdom 28，Node 18 易启动失败）

在 .cursor/mcp.json（推荐提交 Git）中复制以下内容：

json
{
  "mcpServers": {
    "mos-developer-docs": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "url": "https://developer.mosapp.app/llms.txt"
    }
  }
}

若已有其他 MCP，只追加 mos-developer-docs 节点。需要本机 Node.js 18+；首次启用时 npx 会拉取锁定版本的 mcp-fetch-server。

Windows 若 npx 启动失败，将 command / args 改为：

json
{
  "mcpServers": {
    "mos-developer-docs": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "[email protected]"],
      "url": "https://developer.mosapp.app/llms.txt"
    }
  }
}

也可对照线上文件核对：mos-developer-docs.mcp.json

2.4 在设置中启用 MCP（Cursor） ​

写入 .cursor/mcp.json 后，还需在 Cursor Settings（设置）里打开该 MCP 连接：

  1. 打开 Cursor Settings（设置）
  2. 左侧进入 Plugins → Tools & MCPs
  3. 在 Installed MCP Servers 中找到 mos-developer-docs
  4. 将右侧开关拨至 On（开启）；显示如「4 tools enabled」即表示已连接
在 Cursor 设置中启用 mos-developer-docs MCP

2.5 验证 ​

用 Cursor 打开 Agent 会话，输入：

用 MCP 查一下 MosApp 微应用支付流程

结果：能正确回答并输出支付流程文档内容。

3. Skill配置 ​

Skill 提供文档 URL 与查阅顺序；MCP 负责拉取页面内容。

3.1 安装 Skill（推荐团队共享） ​

  1. 复制 mos-developer-docs.skill.md 全文，保存为 .cursor/skills/mos-developer-docs/SKILL.md
  2. 确认路径：.cursor/skills/mos-developer-docs/SKILL.md
  3. 提交 Git 供团队共用

3.2 可复制到项目 Rules 的提示词 ​

text
本项目对接 MosApp 开放平台。文档根地址：https://developer.mosapp.app
1. 使用 MCP fetch 拉取 https://developer.mosapp.app/llms.txt 获取索引
2. 再 fetch 具体页面，如 https://developer.mosapp.app/zh/guide/sdk.html
3. 勿臆造 API；文档未记载的能力应向用户确认