Enemyrr MCP Mysql Server

🚀 @enemyrr/mcp-mysql-server

這是一個提供MySQL數據庫操作的Model Context Protocol服務器，它能讓AI模型通過標準化接口與MySQL數據庫進行交互，為數據庫操作提供了便捷的解決方案。

🚀 快速開始

✨ 主要特性

• 支持通過URL或單獨的環境變量進行配置。
• 使用預處理語句防止SQL注入。
• 支持事務管理。
• 提供詳細的錯誤處理和日誌記錄。

📦 安裝指南

在Cursor IDE中的安裝與設置

通過Smithery安裝

要通過Smithery自動安裝Claude Desktop的MySQL數據庫服務器，可使用以下命令：

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

手動安裝

1. 克隆並構建項目：

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build

2. 在Cursor IDE設置中添加服務器：
   • 打開命令palette（Cmd/Ctrl + Shift + P）
   • 搜索“MCP: Add Server”
   • 填寫字段：
     • 名稱：mysql
     • 類型：command
     • 命令：node /絕對路徑/to/mcp-mysql-server/build/index.js

⚠️ 重要提示

將 /absolute/path/to/ 替換為實際克隆和構建項目的路徑。

數據庫配置

你可以通過三種方式配置數據庫連接：

1. 在.env中使用Database URL（推薦）

DATABASE_URL=mysql://用戶:密碼@主機:3306/數據庫

2. 在.env中使用單獨參數

DB_HOST=localhost
DB_USER=你的用戶
DB_PASSWORD=你的密碼
DB_DATABASE=你的數據庫

3. 直接通過工具連接

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://用戶:密碼@主機:3306/數據庫"
    // 或者
    workspace: "/路徑/to/你的項目" // 將使用項目的.env
    // 或者
    host: "localhost",
    user: "你的用戶",
    password: "你的密碼",
    database: "你的數據庫"
  }
});

💻 使用示例

可用工具

1. connect_db

使用URL、工作區路徑或直接憑據連接到MySQL數據庫。

2. query

執行帶有可選預處理語句參數的SELECT查詢。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. execute

執行帶有可選預處理語句參數的INSERT、UPDATE或DELETE查詢。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["Alice", "alice@example.com"]
  }
});

4. browse_table

瀏覽數據庫表的內容。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "browse_table",
  arguments: {
    table: "users"
  }
});

🔧 技術細節

安全

• 使用預處理語句來防止SQL注入。
• 通過環境變量安全地處理密碼。
• 在執行前驗證查詢。
• 自動關閉連接。

錯誤處理

服務器為以下情況提供詳細錯誤信息：

• 連接失敗
• 無效的查詢或參數
• 缺少配置
• 數據庫錯誤
• 模式驗證錯誤

📄 許可證

本項目採用MIT許可證。

貢獻

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