MCP Server Mysql

🚀 mcp-server-mysql

模型上下文協議（Model Context Protocol）的 MySQL 數據庫服務器，可讓大語言模型 inspect 數據庫架構並執行只讀查詢，為數據交互提供便利。

🚀 快速開始

模型上下文協議（Model Context Protocol）的 MySQL 數據庫服務器，能使大語言模型對數據庫架構進行檢查並執行只讀查詢操作。

✨ 主要特性

• 只讀訪問 MySQL 數據庫，保障數據安全。
• 具備數據庫架構檢查功能，便於瞭解數據庫結構。
• 在 READ ONLY 事務中安全執行查詢，確保操作安全。
• 支持 Docker，方便部署。
• 有 NPM 包可用，便於集成。

📦 安裝指南

使用 Docker

# 構建 Docker 鏡像
make docker

# 使用 Docker 運行
docker run -i --rm mcp/mysql mysql://host:port/dbname

通過 Smithery 安裝

要自動為 Claude Desktop 安裝 MySQL 數據庫服務器 Smithery，可執行以下命令：

npx -y @smithery/cli install @yuru-sha/mcp-server-mysql --client claude

💻 使用示例

基礎用法

與 Claude Desktop 一起使用

將以下配置添加到你的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/mysql",
        "mysql://host:port/dbname"
      ]
    }
  }
}

⚠️ 重要提示

在 macOS 上使用 Docker 時，如果 MySQL 服務器運行在主機網絡上，請將 /database 替換為 host.docker.internal。

連接 URL 格式

mysql://[user][:password]@host[:port]/database

請將 /database 替換為你數據庫的名稱。

🔧 技術細節

# 初始設置
make setup

# 構建項目
make build

# 格式化代碼
make format

# 運行檢查工具
make lint

📄 許可證

此項目在 MIT License 下發布。

安全

此服務器強制執行只讀訪問以保護你的數據庫。所有查詢都在 READ ONLY 事務中執行。為了增強安全性，我們建議創建一個只讀用戶。