Mysql MCP Server L7j

🚀 MySQL MCP 服務器

MySQL MCP 服務器是一個提供只讀訪問 MySQL 數據庫的模型上下文協議（Model Context Protocol）服務器。它讓大型語言模型（LLM）能夠查看數據庫架構並執行只讀查詢，為數據交互提供了便利。

🚀 快速開始

MySQL MCP 服務器允許大型語言模型（LLM）查看數據庫架構並執行只讀查詢。下面將詳細介紹其使用方法。

✨ 主要特性

• 認證支持：通過數據庫 URL 支持 MySQL 認證，確保安全訪問數據庫。
• 工具功能：提供 query 工具，可執行只讀 SQL 查詢，自動處理身份驗證。
• 資源信息：為每個表提供數據庫架構信息，包括列名和數據類型。
• Cursor 集成：支持在 Cursor 中配置和使用，方便與數據庫進行交互。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/yourusername/mysql-mcp-server.git
   cd mysql-mcp-server
   

2. 準備並安裝依賴項：

   npm run prepare
   npm install
   

3. 創建全局鏈接：

   npm link
   

安裝完成後，您可以在終端的任何位置使用 mysql-mcp-server 命令：

mysql-mcp-server mysql://user:password@localhost:3306/mydb

💻 使用示例

在 Cursor 中配置 MCP

1. 打開 Cursor 的設置：
   • 點擊底部左下角的齒輪圖標（⚙️）；
   • 或者按 Shift + Cmd + J（在 macOS 上）。
2. 配置 MCP 服務器：
   • 點擊左側邊欄中的“MCP”；
   • 點擊“添加全局 MCP 服務器”；
   • 添加以下配置：

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": ["mysql://user:password@localhost:3306/mydb"]
    }
  }
}

3. 保存配置：
   • 點擊“保存”或按 Cmd + S；
   • 重啟 Cursor 以使更改生效。

如何在 Cursor 中使用它？

在 Cursor 中的智能聊天窗口打開，並開始與數據庫相關的問題提問，它將擁有所有上下文。

安全最佳實踐

⚠️ 重要提示

• 使用環境變量保存敏感憑證，示例配置如下：

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": ["mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@host:3306/mydb"]
    }
  }
}

• 確保 MySQL 用戶具有最小的必需權限（只讀訪問）。
• 使用強密碼並遵循安全最佳實踐。
• 避免將包含憑證的配置文件提交到版本控制系統。

🔧 技術細節

認證

該服務器通過數據庫 URL 支持 MySQL 認證。URL 格式如下：

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

示例：

• 數據庫：mysql://user:pass@localhost:3306/mydb

組件

工具

• query
  • 執行只讀 SQL 查詢針對連接的數據庫。
  • 輸入：sql（字符串）：要執行的 SQL 查詢。
  • 所有查詢都在一個只讀事務中執行。
  • 使用提供的憑證自動處理身份驗證。

資源

服務器為每個表提供數據庫架構信息：

• 表格架構（mysql://<host>/<table>/schema）
  • 每個表的 JSON 架構信息。
  • 包括列名和數據類型。
  • 自動從數據庫元數據中發現。
  • 使用提供的憑證進行身份驗證訪問。

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目倉庫中的 LICENSE 文件。