Mysql Database Server

🚀 @enemyrr/mcp-mysql-server

一個提供MySQL數據庫操作的Model Context Protocol服務器，該服務器可讓AI模型藉助標準化接口與MySQL數據庫進行交互，為數據操作提供便利。

🚀 快速開始

✨ 主要特性

• 支持多種連接方式（URL、工作區、直接）。
• 提供安全的連接處理和自動清理。
• 支持prepared statements以防止SQL注入。
• 提供Schema管理工具。
• 具有全面的錯誤處理和驗證。
• 支持TypeScript。
• 自動檢測工作區。

📦 安裝指南

通過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://username:password@host:port/database

2. 單獨設置DB參數：

DB_HOST = host
DB_USER = username
DB_PASSWORD = password
DB_NAME = database
DB_PORT = port

3. 通過工具直接連接並提供詳細信息。

💻 使用示例

基礎用法

本服務器提供了一系列實用工具，以下是部分工具的使用示例：

# 建立數據庫連接
connect_db()

# 執行查詢
query("SELECT * FROM table_name")

# 執行非查詢操作
execute("INSERT INTO table_name (column1, column2) VALUES ('value1', 'value2')")

# 列出所有表
list_tables()

# 獲取指定表的列信息
get_columns("table_name")

# 執行自定義查詢
execute_query("SELECT column1 FROM table_name WHERE condition")

# 插入數據
insert_data("table_name", {"column1": "value1", "column2": "value2"})

# 更新數據
update_data("table_name", {"column1": "new_value"}, "condition")

# 刪除數據
delete_data("table_name", "condition")

🔧 技術細節

安全

• 使用prepared statements防止SQL注入。
• 通過環境變量支持安全密碼處理。
• 在執行前驗證查詢。
• 自動關閉連接。

錯誤處理

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

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

📄 許可證

本項目採用MIT許可證。

貢獻

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