MCP Mysql Server

🚀 mcp-mysql-server

mcp-mysql-server 是一個基於模型上下文協議（Model Context Protocol）的 MySQL 數據庫操作服務器。它為 AI 模型提供了標準化接口，使其能夠方便地與 MySQL 數據庫進行交互。

🚀 快速開始

mcp-mysql-server 能讓 AI 模型通過標準化接口與 MySQL 數據庫交互。你可以按照以下步驟進行安裝和配置。

📦 安裝指南

使用以下命令安裝服務器：

npx @malove86/mcp-mysql-server

📚 詳細文檔

配置說明

服務器支持兩種部署模式，下面為你詳細介紹：

1. 本地運行模式

在 MCP 設置配置文件中使用命令行運行，示例配置如下：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@malove86/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

2. 遠程 URL 模式 (v0.2.2+)

指向遠程運行的 MCP 服務器，示例配置如下：

{
  "mcpServers": {
    "mcp-mysql-server": {
      "url": "http://your-server-address:port/mcp-mysql-server"
    }
  }
}

在遠程服務器上，你需要設置環境變量後啟動 MCP 服務器：

# 設置環境變量
export MYSQL_HOST=your_host
export MYSQL_USER=your_user
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=your_database
export MYSQL_PORT=3306  # 可選，默認為3306

# 啟動服務器
npx @malove86/mcp-mysql-server

⚠️ 重要提示

MYSQL_PORT 是可選的，默認值為 3306。

版本功能

v0.2.4+ 新特性

• 多用戶併發支持：服務器現在可同時處理多個用戶的請求
• 高效連接池管理：使用改進的連接池，支持最多 50 個併發連接
• 請求級別隔離：每個請求都有唯一標識符，便於跟蹤和調試
• 詳細日誌記錄：記錄每個請求的執行過程和資源使用情況
• 改進的錯誤處理：更精確地捕獲和報告數據庫錯誤
• 性能優化：連接池複用和優化的連接管理提高處理速度

v0.2.3+ 新特性

• 初始版本：提供基本功能，包括數據庫連接、查詢執行等

可用工具

以下是服務器提供的主要工具：

1. connect_db

用於建立數據庫連接。

{
  "tool": "connect_db",
  "params": {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "mydb"
  }
}

2. query

執行數據庫查詢。

{
  "tool": "query",
  "params": {
    "sql": "SELECT * FROM users LIMIT 10"
  }
}

3. list_tables

列出數據庫中的所有表。

{
  "tool": "list_tables",
  "params": {}
}

4. describe_table

描述指定表的結構。

{
  "tool": "describe_table",
  "params": {
    "table_name": "users"
  }
}

✨ 主要特性

• 高性能：優化了數據庫連接和查詢執行，提升處理速度。
• 高可用性：支持多用戶併發訪問，確保服務穩定。
• 安全性：通過環境變量管理敏感信息，防止數據洩露。
• 可擴展性：支持遠程 URL 模式，便於部署和管理。

🔧 技術細節

性能

• 最大併發連接數：50
• 支持高效的數據庫操作，提升整體性能

安全性

• 用戶隔離：確保不同用戶之間的數據獨立，防止交叉汙染。
• 預防 SQL 注入：通過參數化查詢，避免安全漏洞。
• 權限管理：限制訪問權限，保障數據安全。

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request 到 https://github.com/Malove86/mcp-mysql-server.git

📄 許可證

本項目採用 MIT 許可證。