@davinwang/qiuer-coder-mcp

秋而框架 QScript MCP Server —— 独立运行的 MCP 工具服务，无需安装 VSCode 扩展即可在任意 AI IDE 中通过 MCP 协议调用秋而框架的服务器管理、功能点管理、SQL 脚本管理、工作台管理、BPMN 流程管理和存储管理能力。

安装

方式一：npx 直接运行（推荐）

无需安装，直接通过 npx 运行：

npx -y @davinwang/qiuer-coder-mcp@latest --workspace /path/to/your/workspace

方式二：全局安装

npm install -g @davinwang/qiuer-coder-mcp@latest

安装后可直接使用：

qiuer-coder-mcp --workspace /path/to/your/workspace

IDE 配置

在 IDE 配置文件中添加 MCP Server 配置。--workspace 参数指向包含 .vscode/settings.json 的工作区根目录。

VS Code / Cursor

在项目根目录创建 .vscode/mcp.json（Cursor 使用 .cursor/mcp.json）：

{
  "servers": {
    "qiuer-coder": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@davinwang/qiuer-coder-mcp@latest", "--workspace", "${workspaceFolder}"]
    }
  }
}

Trae

在项目根目录创建 .trae/mcp.json：

{
  "mcpServers": {
    "qiuer-coder": {
      "command": "npx",
      "args": ["-y", "@davinwang/qiuer-coder-mcp@latest", "--workspace", "${workspaceFolder}"]
    }
  }
}

Qoder / Claude Code

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "qiuer-coder": {
      "command": "npx",
      "args": ["-y", "@davinwang/qiuer-coder-mcp@latest", "--workspace", "."]
    }
  }
}

注意：.mcp.json 中不能使用 ${workspaceFolder}——Claude Code 会将 ${...} 视为环境变量引用， 报 "Missing environment variables: workspaceFolder"。Qoder/Claude Code 启动项目级 stdio server 时 工作目录即项目根，因此写 "." 即可；也可改写工作区的实际绝对路径。

参数说明

| 参数 | 说明 | |------|------| | --workspace <path> | 指向包含 .vscode/settings.json 的工作区根目录，MCP Server 将从中读取服务器配置（qiuer.server_list）等设置 |

环境变量

也可以通过环境变量 QIUER_WORKSPACE 指定工作区路径，作为 --workspace 参数的替代方案：

QIUER_WORKSPACE=/path/to/workspace npx -y @davinwang/qiuer-coder-mcp@latest

参数优先级：--workspace > QIUER_WORKSPACE 环境变量 > 当前工作目录（process.cwd()）

工具清单

共提供 9 类 47 个 MCP 工具：

通用工具（3 个）

| 工具名 | 说明 | |--------|------| | server_list | 获取所有已配置的服务器列表 | | app_list | 获取服务器上已部署的应用列表 | | mcp_status | MCP Server 运行状态与各服务器连通性诊断 |

QScript 功能点管理（12 个）

| 工具名 | 说明 | |--------|------| | qscript_list | 获取功能点列表 | | qscript_search | 搜索功能点 | | qscript_get | 获取功能点内容 | | qscript_check_digest | 校验功能点摘要 | | qscript_download | 下载功能点 | | qscript_upload | 上传功能点 | | qscript_create | 基于现有功能点复制创建新功能点 | | qscript_create_blank | 凭空创建空白功能点（仅需 funcid + methid + meta） | | qscript_download_all | 批量下载所有功能点 | | qscript_test | 测试功能点；身份扮演：传 authMode:"impersonate" + impersonation:{id,channel,level?} 以指定身份验证功能点（扮演不改变 Auth 登录身份，$task.userId 仍为配置账号 ID，判断是否生效应对比不同身份的权限/数据差异） | | qscript_find_callers | 查找调用方（谁调用我）：给 funcid+methid 或 code，扫描本地 .qs 返回所有调用方 | | qscript_find_callees | 查找被调用方（我调用谁）：给 funcid+methid 或 code，返回其调用的所有下游方法 |

SQL 脚本管理（8 个）

| 工具名 | 说明 | |--------|------| | sql_list | 获取 SQL 脚本列表 | | sql_search | 搜索 SQL 脚本 | | sql_get | 获取 SQL 脚本内容 | | sql_download | 下载 SQL 脚本 | | sql_upload | 上传 SQL 脚本 | | sql_create | 基于现有脚本创建新 SQL 脚本 | | sql_create_blank | 凭空创建空白 SQL 脚本（仅需 newSqlid + newCode） | | sql_download_all | 批量下载所有 SQL 脚本 |

Desk 工作台管理（6 个）

| 工具名 | 说明 | |--------|------| | desk_list | 获取工作台列表 | | desk_search | 搜索工作台 | | desk_get | 获取工作台内容 | | desk_download | 下载工作台 | | desk_upload | 上传工作台 | | desk_download_all | 批量下载所有工作台 |

BPMN 流程管理（3 个）

| 工具名 | 说明 | |--------|------| | bpmn_list | 获取 BPMN 流程列表 | | bpmn_download | 下载 BPMN 流程 | | bpmn_download_all | 批量下载所有 BPMN 流程 |

Storage 存储管理（3 个）

| 工具名 | 说明 | |--------|------| | storage_list | 获取存储列表 | | storage_get_contents | 获取存储内容列表 | | storage_download | 从存储下载文件到本地工作区 |

运行时资源（9 个）

| 工具名 | 说明 | |--------|------| | connection_list | 列出 HTTP 连接客户端（id/driver/path/route），确定 http.<id>.do 可用连接名 | | cache_list | 列出缓存客户端（driver/id/keyPrefix） | | queue_list | 列出消息队列客户端（driver/id） | | variable_list | 列出系统变量（id/name/scope/permission） | | variable_get | 获取单个系统变量详情 | | scheduler_list | 列出定时任务调度器（id/状态/作业摘要） | | scheduler_get | 获取定时任务详情（含触发器与 context） | | database_list | 列出数据库连接配置（id/jdbcUrl/连接池） | | database_tables | 获取表结构（列名/类型/索引） |

代码质量（2 个）

| 工具名 | 说明 | |--------|------| | qscript_check_syntax | 语法检查（filePath 或 code），返回错误/警告列表 | | qscript_format | 格式化 QScript 代码 |

迁移台账（1 个）

| 工具名 | 说明 | |--------|------| | migration_ledger_generate | 生成/合并单个 app 的迁移台账（<app>/migration_plan.md，由 迁移台账.md 更名，默认路径下新文件缺失时自动以旧文件为合并来源；stationApp 必填，可选 server/output/depDepth/dryRun/force）；「迁移应用/新接口URL/迁移状态/ApiPost链接」人工维护列重复生成不覆盖（迁移状态缺省默认 -- 表示未迁移）；「依赖功能点」基于本地已下载源码自动解析为 HTML 嵌套表（层级/依赖功能点/代号/迁移状态，含传递依赖，深度优先展开：子依赖紧随其父节点；嵌套表迁移状态取自本台账对应行，已填原样显示，未填/未跟踪默认「--」即未迁移）；源端已删除的行保留在表尾并标注；枚举失败自动回退本地 meta 扫描 |

License

MIT