---
name: xiaoma-generate-service-config
description: >-
  从代码与 Nacos 读取当前后端服务配置，生成并合并写入 mcp.json
  （Cursor → .cursor/mcp.json，Claude Code → .mcp.json）。
  数据库与日志 MCP 默认生成（用户明确说不生成则跳过）；
  MongoDB / RocketMQ Console MCP 须用户确认后才生成；不生成 Redis MCP。
  写入后检查并安装对应依赖；Oracle：Instant Client 固定 C:\tools\oracle-mcp，npm 包装到 npm root -g，用 wrapper（禁止裸 npx）。
  用户必须明确指定 test1/test2/test3/test4/test5/uat/yc，禁止猜测环境；RocketMQ Console 仅 test1~test5。
  项目后端服务少于 3 个时全部处理；大于等于 3 个时先询问用户选择服务。
  在用户点名 xiaoma-generate-service-config，或要求生成服务 MCP、mcp.json 时使用。
  Use when the user asks to generate service MCP config or mcp.json for backend services.
disable-model-invocation: true
---

# Xiaoma Generate Service Config

根据当前后端服务 + 测试环境，生成数据库 / MongoDB / RocketMQ Console / 日志 MCP，并写入项目对应配置文件。

**不生成 Redis MCP**（即使用户要求或项目引入了 Redis，本 skill 也不写入 `easy-redis-mcp`）。

**分册（按需阅读，勿混在一个文件里写细则）：**

- 数据库 MCP → [database.md](database.md)
- Oracle 本机运行时（Instant Client + wrapper）→ [oracle-setup.md](oracle-setup.md)
- MongoDB MCP（`mongodb-mcp-server`，默认只读）→ [mongodb.md](mongodb.md)
- RocketMQ Console（`rocketmq-console-mcp` = 通用 HTTP MCP）→ [rocketmq.md](rocketmq.md)
- 日志 MCP → [logs.md](logs.md)

## Nacos 访问方式

访问 Nacos HTTP 接口（拉配置、查服务实例）**建议**用 `curl.exe`：

```bash
curl.exe -s "http://www.{env}.yljr.com/nacos/v1/..."
```

- 建议写全 `curl.exe`：PowerShell 中 `curl` 常是 `Invoke-WebRequest` 的别名，参数与输出都不同，可能报错
- 不建议用 WebFetch：会把 http 自动升级为 https，而 Nacos 仅提供 http，可能拿不到数据
- 上述方式不可行时，自行选择其它合适方式，能拿到 http 明文响应即可

## MCP 生成范围（必遵）

| 类型 | 默认行为 |
|------|----------|
| 数据库 MCP（[database.md](database.md)） | **默认生成**；仅当用户明确说「不生成数据库 / 不要库 MCP」等时跳过 |
| 固定开发库 MCP `xiaoma-dev-mysql`（[database.md](database.md) 第 6 节） | **默认生成**（host 10.111.20.100:33070，允许 UPDATE，禁止 INSERT/DELETE）；仅当用户明确不要时跳过 |
| 日志 MCP（[logs.md](logs.md)） | **默认生成**；仅当用户明确说「不生成日志 / 不要日志 MCP」等时跳过 |
| MongoDB MCP（[mongodb.md](mongodb.md)） | **须用户确认**后才生成；未确认禁止写入 |
| RocketMQ Console MCP（[rocketmq.md](rocketmq.md)） | **须用户确认**后才生成；未确认禁止写入（且仅 test1~test5） |
| Redis MCP | **永不生成**；不询问、不写入、不安装 `easy-redis-mcp` |

确认方式：

1. 扫描项目后，若检测到引入了 MongoDB / RocketMQ，列出「可生成项」询问用户要生成哪些（可多选）；**不要列出 Redis**
2. 用户明确说「生成 mongodb / rocketmq」或「都要 / 全部可选都生成」→ 按确认项执行（仍不含 Redis）
3. 用户未表态 → **只生成数据库 + 日志**，可选两类一律跳过
4. 用户一开始就点名只要某几类 → 以用户点名为准（数据库/日志仍默认开，除非用户明确关掉；点名 Redis 时说明本 skill 不生成 Redis）

## 前置输入

1. **环境（硬性必填）**：用户必须在输入中明确给出 `test1` / `test2` / `test3` / `test4` / `test5` / `uat`（或 `yc` / `dev` 若适用）。
   - **禁止猜测、禁止从上下文/历史/默认值推断测试环境**
   - 用户只说「测试环境 / test」而未指定 `test1`~`test5` → **立即停止配置**，提示：
     > 请明确指定测试环境：`test1` / `test2` / `test3` / `test4` / `test5`（或 `uat`）。未指定环境前不会生成任何 MCP 配置。
   - 未给出任何环境信息 → 同样停止并使用上述提示
   - **RocketMQ Console MCP 仅在 test1~test5 生成**；环境为 uat/yc 时跳过 [rocketmq.md](rocketmq.md)
2. **服务范围（按项目后端服务数量决定）**：先扫描当前项目中的后端服务列表（见下方「服务发现与选择」），再决定为哪些服务生成 MCP。
3. **AI 环境**：`cursor` 或 `claudeCode`（见下方探测；可推断）

## 服务发现与选择（必遵）

扫描当前仓库/工作区，收集后端服务名，来源优先级：

1. 各模块 `spring.application.name`
2. 多模块工程目录名 / `settings.gradle` / `pom.xml` 的 module（仅保留可独立部署的应用模块，排除 `common`/`api`/`client` 等非启动模块）
3. 用户已点名的服务

去重后得到列表 `S`，数量 `N = |S|`：

| N | 行为 |
|---|------|
| `N < 3`（0 除外） | **全部**加入待生成列表，无需再问用户选哪个 |
| `N >= 3` | **停止生成**，列出全部服务名，询问用户要为哪些服务添加 MCP；用户明确选择前禁止写入 |
| `N = 0` | 无法发现服务 → 询问用户直接给出服务名（可多个） |

用户若在一开始就明确指定了服务名（哪怕项目里 ≥3 个），则以用户指定为准，可跳过询问。

多服务生成时：

- **每个选中服务**按「MCP 生成范围」走对应分册（默认库+日志；可选类须已确认；不含 Redis）
- MCP key 带服务名或序号后缀，避免覆盖
- 共用同一数据源、同一 Mongo 连接串、或同一 RocketMQ Console 集群时，对应 MCP **只写一条**并在摘要里说明复用

## AI 环境探测与写入路径

| AI 环境 | 判定线索 | 写入文件 |
|---------|----------|----------|
| Cursor | Cursor 工作区、存在 `.cursor/`、用户说 Cursor | `<project>/.cursor/mcp.json` |
| Claude Code | 用户说 Claude / Claude Code、存在 `.claude/` 或 `.mcp.json` | `<project>/.mcp.json` |

- 结构均为 `{ "mcpServers": { ... } }`
- **已有配置则合并追加**：保留原有 server；同名 key 用新生成内容覆盖
- **不要删除**用户已有的 Redis 等无关 MCP（本 skill 只是不新写 Redis）
- 写完后输出本次新增/更新的 server 名称摘要

## 总流程

```
Task Progress:
- [ ] 1. 校验用户是否明确给出环境（未给出则停止并提示，禁止继续）
- [ ] 2. 扫描项目后端服务列表
- [ ] 3. N<3 → 全部处理；N≥3 → 询问用户选择服务（未选则停止）；用户已指定服务则用指定
- [ ] 4. 确认 AI 环境；确认 MCP 范围（库+日志默认开；Mongo/MQ 须用户确认；不生成 Redis）
- [ ] 5. 默认：按 database.md 生成数据库 MCP（用户明确不要则跳过）；并默认写入固定的 `xiaoma-dev-mysql`（用户明确不要则跳过）
- [ ] 6. 仅当用户确认：按 mongodb.md 生成 MongoDB MCP（未引入则跳过）
- [ ] 7. 仅当用户确认且 test1~test5：按 rocketmq.md 生成 rocketmq-console-mcp
- [ ] 8. 默认：按 logs.md 生成日志 MCP（用户明确不要则跳过；有效路径全部写入）
- [ ] 9. 合并写入 mcp.json
- [ ] 10. 按下方「依赖检查与安装」安装本次用到的 npm 包（失败则告知用户）
- [ ] 11. 按 AI 环境提示重启/启用方式
```

步骤 5→[database.md](database.md)；6→[mongodb.md](mongodb.md)；7→[rocketmq.md](rocketmq.md)；8→[logs.md](logs.md)。**禁止**执行 Redis 生成。

## 写入与收尾

1. 读取目标 mcp.json（不存在则创建 `{ "mcpServers": {} }`）
2. 合并本次生成的 database + mongodb + rocketmq-console-mcp + ssh-logs 条目：
   - 新 key 直接加入；同名 key 覆盖为本次生成值
   - 不删除用户其它无关 MCP
   - 写回美化后的 JSON（2 空格缩进）
3. **执行「依赖检查与安装」**（见下节）；安装失败须明确告知用户，但**不回滚**已写入的 mcp.json
4. **必须**按 AI 环境提示用户：

**Claude Code：**

> 配置已写入 `.mcp.json`。请重新启动 Claude 后再使用这些 MCP。

**Cursor：**

> 配置已写入 `.cursor/mcp.json`。请到 Settings → Tools & MCPs 启用本 MCP，并 Reload 后生效。

## 依赖检查与安装（必遵）

mcp.json 写完后，针对**本次实际写入**的 MCP，检查并安装对应 npm 包。未写入的类型不要装。**不对 Redis / `easy-redis-mcp` 做检查或安装。** 安装一律内联 `--registry` 内网源（见「npm 源」），**禁止** `npm config set registry`；**已安装的包与已存在的文件一律跳过，不重复下载**。

### 包映射

| 本次写入的 MCP | npm 包 / 依赖 |
|----------------|----------------|
| MySQL（`mcp_server_mysql*` / `xiaoma-dev-mysql`） | 全局：`@benborla29/mcp-server-mysql` |
| Oracle（`*_oracle`） | **拆分**：Instant Client → `C:\tools\oracle-mcp`（缺失时自动从共享拉取，已装跳过）；npm：`npm install -g oracledb oracle-mcp-server --registry http://172.16.30.100:8081/repository/npm-group/`（目标为 `npm root -g`）；启动用 wrapper（见 [oracle-setup.md](oracle-setup.md)） |
| MongoDB（`mongodb*`） | 全局：`mongodb-mcp-server` |
| RocketMQ Console（`rocketmq-console-mcp`） | 全局：`@anushibinj/fetch-mcp` |
| 日志（`ssh-logs*`） | 全局：`@thesashadev/ssh-mcp-server` |

**Oracle 额外检查（写入 Oracle 时必做）：**

1. 探测 `<NODE_EXE>`（`where node`）、`<NPM_ROOT>`（`npm root -g`）
2. 检查 `C:\tools\oracle-mcp\instantclient-basic-windows.x64-11.2.0.4.0\instantclient_11_2\oci.dll`：**已存在 → 跳过 Instant Client 全部步骤**；缺失 → Agent 自动从共享拉取并解压（见 [oracle-setup.md](oracle-setup.md)），禁止解压进含中文项目目录
3. 检查 `<NPM_ROOT>\oracle-mcp-server\build\index.js` 与 `<NPM_ROOT>\oracledb`：**均已存在 → 跳过 npm 安装**；缺失才装
4. 复制 skill 内 [oracle-mcp-wrapper.mjs](scripts/oracle-mcp-wrapper.mjs) → `<PROJECT_ROOT>\.claude\oracle-mcp-wrapper.mjs`（**已存在则跳过**）
5. mcp.json 使用 `ORACLE_NPM_ROOT` + `ORACLE_IC_HOME=C:\tools\oracle-mcp`（**不要** `ORACLE_MCP_HOME`）
6. 缺 npm 包：`npm install -g oracledb@^5.5.0 oracle-mcp-server@^0.1.3 --registry http://172.16.30.100:8081/repository/npm-group/`；**禁止**在 `C:\tools\oracle-mcp` 下 `npm install`

### npm 源（必遵）

所有 `npm install` 一律通过 `--registry` 内联指定公司内网源（含末尾 `/`）：

```text
http://172.16.30.100:8081/repository/npm-group/
```

- **禁止**执行 `npm config set registry`（不得修改用户 npm 全局配置）
- 无需预先检查全局 registry；`--registry` 只影响当次安装命令

### 步骤

1. 确认本机有 `node` / `npm`（`node -v`、`npm -v`）。若没有：
   > 未检测到 Node.js/npm，无法安装 MCP 依赖。请先安装 Node.js 后重试，或手动执行下方安装命令。
   列出待装包名与预估时间后结束本步（配置仍保留）。
2. 无需检查/修改全局 registry；安装命令一律内联 `--registry` 指向内网源（见「npm 源」）。
3. 对每个待装包检查是否已可用，任选其一即可判定「已安装」；**已安装则跳过，不重复下载/安装**：
   - `npm list -g --depth=0 <package>` 成功且无 `empty`
   - 或 `npm root -g` 下存在对应目录
4. **未安装才安装**（全局，带内网源）：

```bash
npm install -g <package> --registry http://172.16.30.100:8081/repository/npm-group/
```

一次可装多个，例如：

```bash
npm install -g @benborla29/mcp-server-mysql @thesashadev/ssh-mcp-server --registry http://172.16.30.100:8081/repository/npm-group/
```

5. 安装后再次 `npm list -g --depth=0 <package>` 校验。
6. 向用户输出摘要：已存在跳过 / 新安装成功 / **安装失败**（须含带 `--registry` 的手动命令 + 预估下载时间）。

### 预估下载时间（告知用户时必带）

按内网 `npm-group`、常见办公网粗估（单包全局安装，含依赖；仅供参考）：

| 包 | 预估 |
|----|------|
| `@benborla29/mcp-server-mysql` | 约 1～3 分钟 |
| `oracle-mcp-server` + `oracledb`（`npm install -g` → npm root） | 约 2～5 分钟 |
| Instant Client rar → `C:\tools\oracle-mcp`（共享复制+解压） | 约 1～3 分钟（视 SMB） |
| `mongodb-mcp-server` | 约 2～4 分钟 |
| `@anushibinj/fetch-mcp` | 约 1～2 分钟 |
| `@thesashadev/ssh-mcp-server` | 约 1～3 分钟 |

多个包合计：各包预估相加，并说明「视网络与缓存可能更快或更慢」。安装失败、需用户手动装时，也必须带上上述预估。

### 失败处理（依赖）

- **内网源不可达 / 404**：给出带 `--registry http://172.16.30.100:8081/repository/npm-group/` 的完整手动命令与预估时间；提示用户先确认处于内网/VPN；**禁止**改用 `npm config set registry`
- 权限错误（EACCES / 需管理员）：提示用管理员 CMD 重试，或：

```bat
npm install -g <package> --registry http://172.16.30.100:8081/repository/npm-group/ --prefix "%APPDATA%/npm"
```

- 网络/超时：确认内网连通后重试；仍失败则给出完整手动命令与预估时间
- 某包失败、其它成功：成功的照常说明；失败的单独列出手动命令与预估；**不阻断**重启/Reload 提示
- **禁止**静默忽略安装失败

## 失败处理

| 情况 | 处理 |
|------|------|
| 未明确给出环境（含只说「测试/test」） | **停止全部配置**，提示用户指定 `test1`/`test2`/`test3`/`test4`/`test5`/`uat` |
| 发现 ≥3 个后端服务且用户未指定要哪些 | **停止生成**，列出服务清单请用户选择 |
| 找不到任何后端服务 | 询问用户提供服务名 |
| 找不到 database dataId | 列出已发现的 nacos ext-config，请用户指定 |
| 未确认 MongoDB / RocketMQ | 不生成对应 MCP（即使项目已引入） |
| 用户要求生成 Redis | 说明本 skill **不生成** Redis MCP，继续其它项 |
| 用户明确不要数据库或日志 | 跳过对应默认项 |
| 未引入 MongoDB / RocketMQ | 即便用户确认也可跳过并说明原因 |
| RocketMQ namesrv 无法归类 | 列出原始值，请用户选公共/核心/融资 |
| 服务无实例 IP | 提示先启动服务，不写日志 MCP（其它 MCP 仍可写） |
| 内网 npm 源不可达 | 给出带 `--registry http://172.16.30.100:8081/repository/npm-group/` 的手动 `npm install -g …` 与预估下载时间；提示确认内网/VPN；**禁止**执行 `npm config set registry` 改全局配置 |
| MCP 依赖安装失败 | 告知包名与错误原因，给出带 `--registry` 的手动安装命令与预估时间；mcp.json 保留 |
| 无法判断 AI 环境 | 询问后写入对应文件 |
