local-mysql MCP 서버

MySQL 데이터베이스를 VSCode(및 Copilot CLI)에 노출하는 로컬 개발용 MCP 서버입니다. query(SELECT 전용)와 execute(INSERT / UPDATE 전용)라는 두 가지 도구를 제공합니다.

본 서버는 로컬 개발 전용입니다. 운영 환경에 배포하거나 운영 DB에 연결하지 마십시오.

연결 설정

기본값은 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 프로토콜 프레임 전용입니다