local-mysql MCP 服务器

这是一个用于本地开发的 MCP 服务器，将 FO MySQL 数据库暴露给 VSCode（以及 Copilot CLI）。它提供了两个工具：query（仅限 SELECT）和 execute（仅限 INSERT / UPDATE）。

本服务器仅供本地开发使用。请勿将其部署到生产环境或连接到生产数据库。

连接设置

默认值与 src/main/resources/application.yml 一致。

连接池是 模式无关的，不会绑定到默认数据库。请在每次调用时通过 schema 参数指定模式，或使用完全限定名（如 oa.t_xxx）。允许的模式：fo、oa、bo、cm、nepro。

Related MCP server: MySQL MCP Server

安装与构建

cd mcp-server
npm install
npm run build

构建完成后，请重启 MCP 客户端（VSCode / Copilot CLI）以重新加载配置。

如果希望在不重新构建的情况下进行迭代开发：

npm run dev

工具

query — 只读 SELECT

{
  "sql": "SELECT id, name FROM m_article WHERE id = ?",
  "params": [123],
  "schema": "fo"          // 省略可
}

返回值：

{
  "schema": "fo",
  "rowCount": 1,
  "truncated": false,
  "maxRows": 1000,
  "fields": [{ "name": "id", "type": 3 }, { "name": "name", "type": 253 }],
  "rows": [{ "id": 123, "name": "..." }]
}

限制：

• 仅限单条语句（拒绝多条语句）

• 必须以 SELECT 开头（v1 版本不支持 CTE / WITH）

• 结果上限：1000 行。如果 truncated: true，则表示存在更多行

execute — INSERT 或 UPDATE

{
  "sql": "UPDATE m_article SET name = ? WHERE id = ?",
  "params": ["new name", 123],
  "schema": "fo"
}

返回值：

{
  "schema": "fo",
  "affectedRows": 1,
  "insertId": 0,
  "changedRows": 1,
  "warningStatus": 0
}

限制：

• 仅限单条语句

• 必须以 INSERT 或 UPDATE 开头

• DELETE、DROP、ALTER、CREATE、TRUNCATE、RENAME、GRANT、REVOKE、REPLACE、MERGE、CALL、LOAD、HANDLER、LOCK、UNLOCK、SET、USE、START、BEGIN、COMMIT、ROLLBACK、SAVEPOINT — 全部拒绝

集成方式

将此仓库克隆到使用本服务器的项目同级目录下，并采用以下目录结构：

parent/
├── mcp-local-mysql/        ← このリポジトリ
└── your-project/
    └── .vscode/mcp.json    （Copilot CLI の場合は .mcp.json）

VSCode

在项目根目录下添加 .vscode/mcp.json。根键为 servers：

{
  "servers": {
    "local-mysql": {
      "command": "node",
      "args": ["../mcp-local-mysql/dist/index.js"],
      "env": {}
    }
  }
}

如果需要为每个工作区覆盖凭据，请编辑 env 对象。例如：

"env": { "FO_DB_USER": "devuser", "FO_DB_PASS": "devpass" }

此外，为了让 VSCode 识别 .vscode/mcp.json，请在 .vscode/settings.json 中启用 MCP 发现功能：

{
  "chat.mcp.discovery.enabled": true
}

Copilot CLI

在项目根目录下添加 .mcp.json。根键为 mcpServers：

{
  "mcpServers": {
    "local-mysql": {
      "command": "node",
      "args": ["../mcp-local-mysql/dist/index.js"],
      "env": {}
    }
  }
}

安全注意事项

• 在驱动程序级别设置 multipleStatements: false（作为验证器之外的多层防御）

• 所有查询均已参数化 — 值必须通过 params 传递，请勿直接嵌入 SQL 字符串中

• 模式名称在与白名单匹配后会被嵌入到 USE `...` 中

• 服务器日志仅输出到 stderr。stdout 仅用于 MCP 协议帧