F4ww4z MCP Mysql Server

🚀 @f4ww4z/mcp-mysql-server

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

🚀 快速開始

本服務器可助力AI模型藉助標準接口與MySQL數據庫進行交互。你可參考以下內容完成安裝、配置並使用。

📦 安裝指南

使用Smithery安裝

通過Smithery自動安裝適用於Claude Desktop的MySQL Server：

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

手動安裝

npx @f4ww4z/mcp-mysql-server

📚 詳細文檔

配置

服務器需要在您的MCP設置配置文件中設置以下環境變量：

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

可用工具

1. connect_db

使用提供的憑證連接到MySQL數據庫。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

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: ["John Doe", "john@example.com"]
  }
});

4. list_tables

列出數據庫中的所有表。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables",
  arguments: {}
});

5. describe_table

獲取特定表格的結構。

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

✨ 主要特性

• 安全的連接處理，帶自動清理
• 支持預處理語句以防止SQL注入
• 全面的錯誤處理和驗證
• TypeScript支持
• 自動連接管理

🔧 技術細節

安全

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

錯誤處理

服務器為常見問題提供詳細的錯誤消息：

• 連接失敗
• 無效查詢
• 缺少參數
• 數據庫錯誤

🤝 貢獻

歡迎貢獻！請隨意提交拉取請求到 https://github.com/f4ww4z/mcp-mysql-server

📄 許可證

MIT