Michael7736 Mysql MCP Server

🚀 MySQL MCP 服務器

MySQL MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務，它為用戶提供了對 MySQL 數據庫的便捷訪問途徑。藉助該服務器，代理能夠輕鬆執行各類針對 MySQL 數據庫的 SQL 查詢。

🚀 快速開始

在使用 MySQL MCP 服務器之前，你需要確保滿足以下先決條件：

• Node.js (v14 或更高版本)
• MySQL 服務器
• MCP SDK

✨ 主要特性

• 多樣化 SQL 查詢執行：支持在 MySQL 數據庫上執行多種類型的 SQL 查詢，涵蓋讀取數據（SELECT 語句）、創建表（CREATE TABLE 語句）、插入數據（INSERT INTO 語句）、更新數據（UPDATE 語句）以及刪除數據（DELETE FROM 語句）。
• JSON 格式結果返回：將查詢結果以 JSON 格式返回，方便數據處理和解析。
• 可配置數據庫連接：提供可配置的數據庫連接設置，滿足不同環境的需求。
• 事務日誌記錄：為所有操作生成帶有唯一標識符的事務日誌，便於審計和追溯。

📦 安裝指南

1. 克隆或下載此倉庫。
2. 安裝依賴項：

cd mysql-mcp-server
npm install

3. 構建服務器：

npm run build

🛠️ 配置說明

環境變量配置

MySQL MCP 服務器通過以下環境變量進行配置：

數據庫設置

1. 創建 MySQL 數據庫：

CREATE DATABASE mcpdb;

2. 創建具有訪問數據庫權限的 MySQL 用戶：

CREATE USER 'mcp101'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON mcpdb.* TO 'mcp101'@'localhost';
FLUSH PRIVILEGES;

3. 創建測試表：

USE mcpdb;
CREATE TABLE products (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(255),
    price DECIMAL(10, 2)
);

MCP 配置

在不同的環境中配置 MySQL MCP 服務器，以 VS Code 為例，在 settings.json 中添加以下內容：

{
    "mcp.servers": [
        {
            "name": "mysql-mcp-server",
            "type": "mysql",
            "host": "localhost",
            "port": 3306,
            "database": "mcpdb",
            "user": "mcp101"
        }
    ]
}

💻 使用示例

基礎用法

在對話中使用以下語法調用工具：

{
    "tools": {
        "mysql-mcp-server": {
            "function": "executeQuery",
            "args": {
                "query": "SELECT * FROM products LIMIT 5;"
            }
        }
    }
}

高級用法

執行查詢

用於執行任意的 SQL 查詢。 參數：

• query：要執行的 SQL 查詢字符串。 示例：

{
    "query": "SELECT * FROM products LIMIT 5;"
}

創建表

用於創建新的數據庫表。 參數：

• query：CREATE TABLE 語句。 示例：

{
    "query": "CREATE TABLE users (id INT PRIMARY KEY, username VARCHAR(255), email VARCHAR(255));"
}

插入數據

用於向表中插入新記錄。 參數：

• query：INSERT INTO 語句。 示例：

{
    "query": "INSERT INTO products (name, price) VALUES ('Laptop', 999.99), ('Smartphone', 499.99);"
}

更新數據

用於更新表中的記錄。 參數：

• query：UPDATE 語句。 示例：

{
    "query": "UPDATE products SET price = 899.99 WHERE name = 'Laptop';"
}

刪除數據

用於從表中刪除記錄。 參數：

• query：DELETE FROM 語句。 示例：

{
    "query": "DELETE FROM products WHERE name = 'Smartphone';"
}

⚠️ 安全注意事項

• 使用專用 MySQL 用戶，併為其分配適當的權限。
• 若僅需查詢數據，可考慮使用只讀權限。
• 安全存儲敏感信息，如數據庫憑證。
• 所有操作均帶有唯一事務 ID，便於審計。