MySQL MCP 서버

MySQL 데이터베이스와 상호작용하기 위한 MCP 서버.

이 서버는 읽기 전용 쿼리(query) 실행과 최종적으로 롤백되는 쓰기 쿼리(test_execute) 실행을 지원합니다.

설정

환경 변수

~/.mcp/.env 에 다음 환경 변수를 추가합니다.

지엑스피1

참고 : host.docker.internal 은 Docker 컨테이너에서 호스트 머신 서비스에 액세스하기 위한 특수 DNS 이름입니다. 호스트 머신에서 실행 중인 MySQL 서버에 연결할 때 이 설정을 사용하세요. 다른 MySQL 서버에 연결하는 경우 적절한 호스트 이름으로 변경하세요.

mcp.json 구성

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--add-host=host.docker.internal:host-gateway",
        "--env-file",
        "/Users/username/.mcp/.env",
        "ghcr.io/xiangma9712/mcp/mysql"
      ]
    }
  }
}

용법

서버 시작

docker run -i --rm --add-host=host.docker.internal:host-gateway --env-file ~/.mcp/.env ghcr.io/xiangma9712/mcp/mysql

참고 : OrbStack을 사용하는 경우 host.docker.internal 자동으로 지원되므로 --add-host 옵션을 생략할 수 있습니다. Docker Desktop도 일반적으로 이 옵션을 자동으로 지원하지만, 안정성 향상을 위해 --add-host 옵션을 추가하는 것이 좋습니다.

사용 가능한 명령

1. 읽기 전용 쿼리 실행

{
  "type": "query",
  "payload": {
    "sql": "SELECT * FROM your_table"
  }
}

응답:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "example"
    }
  ]
}

2. 테스트 쿼리 실행

{
  "type": "test_execute",
  "payload": {
    "sql": "UPDATE your_table SET name = 'updated' WHERE id = 1"
  }
}

응답:

{
  "success": true,
  "data": "The UPDATE SQL query can be executed."
}

3. 테이블 나열

{
  "type": "list_tables"
}

응답:

{
  "success": true,
  "data": ["table1", "table2", "table3"]
}

4. 테이블 설명

{
  "type": "describe_table",
  "payload": {
    "table": "your_table"
  }
}

응답:

{
  "success": true,
  "data": [
    {
      "Field": "id",
      "Type": "int(11)",
      "Null": "NO",
      "Key": "PRI",
      "Default": null,
      "Extra": ""
    },
    {
      "Field": "name",
      "Type": "varchar(255)",
      "Null": "YES",
      "Key": "",
      "Default": null,
      "Extra": ""
    }
  ]
}

구현 세부 사항

TypeScript로 구현됨
mysql2 패키지를 사용합니다
Docker 컨테이너로 실행됩니다
표준 입력을 통해 JSON 명령을 수락합니다.
표준 출력을 통해 JSON 응답을 반환합니다.
host.docker.internal 사용하여 호스트 MySQL에 연결합니다(OrbStack 및 Docker Desktop과 호환).

보안 고려 사항

민감한 정보 관리를 위해 환경 변수를 사용합니다.
SQL 주입 방지는 구현자의 책임입니다.
프로덕션 사용에 적합한 네트워크 구성이 필요합니다.
호스트 머신 서비스에 연결할 때 적절한 방화벽 설정이 필요합니다.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

JSON 명령을 통해 MySQL 데이터베이스와 상호 작용하고, 읽기 전용 쿼리, 쓰기 쿼리의 테스트 실행, Docker를 통한 테이블 정보 검색을 지원합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP-MySQL Server
enemyrr
A
security
F
license
A
quality
Enables AI models to perform MySQL database operations through a standardized interface, supporting secure connections, query execution, and comprehensive schema management.
Last updated -
7
35
26
JavaScript
MCP MySQL Server
TristanLib
-
security
F
license
-
quality
Facilitates interaction with a local MySQL database via a RESTful API, supporting database queries and real-time updates with integration for Cursor MCP services.
Last updated -
4
JavaScript
MySql MCP Server
sussa3007
A
security
A
license
A
quality
Connect and interact with MySQL databases seamlessly. Execute SQL queries, manage database connections, and retrieve data directly through AI assistants. Enhance your AI capabilities with structured access to your MySQL data.
Last updated -
9
4
15
TypeScript
MIT License
MySQL MCP Server
amornpan
-
security
F
license
-
quality
Enables secure interaction with MySQL databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Last updated -
Python

View all related MCP servers

MySQL MCP Server