Sign inSign up

yinjiangyue/mysql-mcp-server

By yinjiangyue

•Updated 2 months ago

Image
0

274

yinjiangyue/mysql-mcp-server repository overview

https://gitee.com/creekmoon/mysql-mcp-server⁠

⁠mysql-mcp-server

开箱即用:本仓库已发布中央镜像,推荐用 Docker 启动。
镜像:yinjiangyue/mysql-mcp-server:v1.0.0

声明:初版 FORK 自 @davewind/mysql-mcp-server⁠,由本人做了部分重构,请勿与上游 npm 包直接等同。

给 LLM 提供 MySQL 只读访问:能看库表结构,能跑 SELECT,不能改数据、不能改表结构。

  +-------------------+      MCP       +---------------------+     只读 SQL     +---------+
  |  LLM / MCP Client | <------------> |  mysql-mcp-server   | <--------------> |  MySQL  |
  +-------------------+  http / stdio  +---------------------+                 +---------+
                                                 |
                    +----------------------------+----------------------------+
                    |                            |                            |
             list_databases                 list_tables                     query
              (列出数据库)                   (列出表)              (SELECT / WITH / 子查询)

⁠你能用它做什么

  1. 让 AI 助手先摸清有哪些库、哪些表、字段是什么
  2. 让 AI 执行只读 SQL,查数据做问答 / 排障
  3. 用 HTTP 做中央化部署(多客户端并发);也支持 stdio 本地直连

不能做什么: INSERT / UPDATE / DELETE、建改删表、往服务器写文件。生产环境请再给数据库账号加只读权限,作为最后一道防线。


⁠快速启动(首选:Docker)

⁠1. 写 docker-compose.yml
# 示例:拉取并运行 mysql-mcp-server
# 1. 按需修改下方 MYSQL_URL
# 2. docker compose up -d
services:
  mysql-mcp-server:
    image: yinjiangyue/mysql-mcp-server:v1.0.0
    ports:
      - "12024:12024"
    environment:
      # 必填:改成你的 MySQL 连接串;同 compose 网络内请用服务名,勿用 localhost
      MYSQL_URL: mysql://user:password@host:3306/database
      MCP_TRANSPORT: http
      MCP_PORT: "12024"
      MYSQL_CONNECTION_LIMIT: "20"
      MYSQL_QUEUE_LIMIT: "100"
      MYSQL_QUERY_TIMEOUT_MS: "120000"

Tag summary

Content type

Image

Digest

sha256:88c511932…

Size

70.2 MB

Last updated

2 months ago

docker pull yinjiangyue/mysql-mcp-server:v1.2.0