Mysql Database Server Nnk

🚀 @enemyrr/mcp-mysql-server

這是一個提供MySQL數據庫操作的模型上下文協議（Model Context Protocol）服務器。藉助此服務器，AI模型能夠通過標準化接口與MySQL數據庫進行交互。

🚀 快速開始

✨ 主要特性

• 支持多種連接方式（URL、工作區、直接）
• 提供安全的連接處理和自動清理功能
• 支持預編譯語句以防止SQL注入
• 包含數據庫表結構管理工具
• 具備全面的錯誤處理和驗證機制
• 支持TypeScript
• 自動檢測工作區

📦 安裝指南

針對Cursor IDE

使用Smithery自動安裝

通過Smithery自動安裝適用於Claude桌面版的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: 添加服務器”
   • 填寫以下信息：
     • 名稱：mysql
     • 類型：command
     • 命令：node /絕對路徑/to/mcp-mysql-server/build/index.js

⚠️ 重要提示

將/絕對路徑/to/mcp-mysql-server替換為實際的項目路徑。

數據庫配置

• 使用數據庫URL環境變量：

  DATABASE_URL=mysql://用戶名:密碼@主機:端口/數據庫名
  

• 單獨參數配置：

  • 用戶名：通過DB_USER或從URL解析。
  • 密碼：通過DB_PASS或從URL解析。
  • 主機：通過DB_HOST或從URL解析。
  • 端口：通過DB_PORT或從URL解析，默認為3306。
  • 數據庫名：通過DB_NAME或從URL解析。

• 直接連接工具：

  {
    "driver": "mysql",
    "options": {
      "host": "主機地址",
      "port": 端口號,
      "database": "數據庫名稱",
      "username": "用戶名",
      "password": "密碼"
    }
  }
  

💻 使用示例

基礎用法

查詢執行

/**
 * @param {string} query SQL查詢語句
 * @param {any[]} parameters 查詢參數數組
 */
async function executeQuery(query, parameters) => Promise<void>

查詢獲取結果集

/**
 * @param {string} query SQL查詢語句
 * @param {any[]} parameters 查詢參數數組
 */
async function queryResultSet(query, parameters) => Promise<Row[]>

📚 詳細文檔

安全性

• 使用預編譯語句防止SQL注入攻擊
• 通過環境變量安全處理密碼
• 在執行前對查詢進行驗證
• 執行完成後自動關閉連接

錯誤處理

服務器提供詳細的錯誤信息，涵蓋以下情況：

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

📄 許可證

MIT

貢獻

歡迎社區貢獻！請訪問GitHub倉庫提交Pull Request。