local-mysql MCP-Server

Ein MCP-Server für die lokale Entwicklung, der FO MySQL-Datenbanken für VSCode (und die Copilot CLI) bereitstellt. Er bietet zwei Tools: query (nur für SELECT) und execute (nur für INSERT / UPDATE).

Dieser Server ist ausschließlich für die lokale Entwicklung bestimmt. Bitte nicht in Produktionsumgebungen bereitstellen oder mit Produktionsdatenbanken verbinden.

Verbindungseinstellungen

Die Standardwerte entsprechen denen in src/main/resources/application.yml.

Der Verbindungspool ist schema-unabhängig und nicht an eine Standarddatenbank gebunden. Geben Sie das Schema bei jedem Aufruf über den Parameter schema an oder verwenden Sie vollqualifizierte Namen wie oa.t_xxx. Zulässige Schemata: fo, oa, bo, cm, nepro.

Related MCP server: MySQL MCP Server

Installation und Build

cd mcp-server
npm install
npm run build

Starten Sie nach dem Build den MCP-Client (VSCode / Copilot CLI) neu, um die Konfiguration neu zu laden.

Für iterative Entwicklung ohne erneuten Build:

npm run dev

Tools

query — Schreibgeschütztes SELECT

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

Rückgabewert:

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

Einschränkungen:

• Nur einzelne Statements (mehrere Statements werden abgelehnt)

• Muss mit SELECT beginnen (in v1 werden CTE / WITH nicht unterstützt)

• Ergebnislimit: 1000 Zeilen. Wenn truncated: true gesetzt ist, bedeutet dies, dass weitere Zeilen vorhanden sind.

execute — INSERT oder UPDATE

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

Rückgabewert:

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

Einschränkungen:

• Nur einzelne Statements

• Muss mit INSERT oder UPDATE beginnen

• DELETE, DROP, ALTER, CREATE, TRUNCATE, RENAME, GRANT, REVOKE, REPLACE, MERGE, CALL, LOAD, HANDLER, LOCK, UNLOCK, SET, USE, START, BEGIN, COMMIT, ROLLBACK, SAVEPOINT — alle werden abgelehnt

Einbindung

Klonen Sie dieses Repository parallel zu dem Projekt, das diesen Server verwendet, und stellen Sie die folgende Verzeichnisstruktur sicher:

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

VSCode

Fügen Sie .vscode/mcp.json im Stammverzeichnis des Projekts hinzu. Der Root-Key ist servers:

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

Wenn Sie die Anmeldedaten pro Arbeitsbereich überschreiben möchten, bearbeiten Sie das env-Objekt. Beispiel:

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

Stellen Sie außerdem sicher, dass die MCP-Erkennung in .vscode/settings.json aktiviert ist, damit VSCode .vscode/mcp.json erkennt:

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

Copilot CLI

Fügen Sie .mcp.json im Stammverzeichnis des Projekts hinzu. Der Root-Key ist mcpServers:

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

Sicherheitshinweise

• multipleStatements: false ist auf Treiberebene konfiguriert (Defense-in-Depth zusätzlich zum Validator)

• Alle Abfragen sind parametrisiert — Werte müssen immer über params übergeben werden und dürfen nicht direkt in den SQL-String eingebettet werden

• Schemanamen werden gegen eine Whitelist geprüft, bevor sie in USE `...` eingebettet werden

• Server-Logs werden nur nach stderr ausgegeben. stdout ist ausschließlich für das MCP-Protokoll reserviert