Mariadb MCP Server

🚀 MariaDB/MySQL MCP 服務器

本項目是一個 MariaDB/MySQL MCP 服務器，可幫助用戶便捷地進行數據庫管理、表管理以及數據操作等功能。

🚀 快速開始

要使用 MariaDB/MySQL MCP 服務器，您可以按照以下步驟進行操作：

1. 安裝服務器。
2. 進行相關配置。
3. 啟動服務器。

下面將為您詳細介紹每個步驟。

📦 安裝指南

1. 從 NPM 安裝

您可以使用以下命令將 MariaDB/MySQL MCP 服務器安裝到您的系統中：

npm install -g mariadb-mcp-server

2. 從源代碼構建

如果您希望從源代碼構建，請按照以下步驟操作：

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

📚 詳細文檔

配置

環境變量配置

在運行服務器之前，請確保設置以下環境變量：

• MARIADB_HOST：數據庫主機地址，默認為 localhost。
• MARIADB_PORT：數據庫端口號，默認為 3306。
• MARIADB_USER：數據庫用戶名。
• MARIADB_PASSWORD：數據庫用戶密碼。

配置文件

您可以在項目的根目錄下找到 config.json 文件，用於配置服務器的其他參數，例如：

{
  "port": 3000,
  "debug": false,
  "logLevel": "info"
}

啟動服務器

啟動服務器的命令如下：

npm start

✨ 主要特性

1. 數據庫管理

• 創建數據庫：

CREATE DATABASE your_database;

• 刪除數據庫：

DROP DATABASE your_database;

• 使用數據庫：

USE your_database;

2. 表管理

• 創建表：

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  username VARCHAR(50) NOT NULL,
  email VARCHAR(100) NOT NULL UNIQUE
);

• 刪除表：

DROP TABLE users;

3. 數據操作

• 插入數據：

INSERT INTO users (username, email) VALUES ('john', 'john@example.com');

• 查詢數據：

SELECT * FROM users WHERE id = 1;

• 更新數據：

UPDATE users SET username = 'johndoe' WHERE id = 1;

• 刪除數據：

DELETE FROM users WHERE id = 1;

💻 使用示例

創建用戶表並插入數據

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  username VARCHAR(50) NOT NULL,
  email VARCHAR(100) NOT NULL UNIQUE
);

INSERT INTO users (username, email) VALUES ('alice', 'alice@example.com');

查詢用戶表中的所有數據

SELECT * FROM users;

🔧 技術細節

錯誤處理

常見錯誤及解決方案

1. 連接超時
   • 檢查數據庫服務是否正在運行。
   • 確保防火牆沒有阻止端口 3306。
2. 權限不足
   • 確保數據庫用戶擁有足夠的權限。
   • 使用以下命令授予權限：

GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'localhost' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;

3. 語法錯誤
   • 檢查 SQL 語句的語法是否正確。
   • 使用數據庫管理工具驗證查詢。

📄 許可證

本項目基於 Lucas 的 MySQL MCP 服務器 開發，更多信息請參考以下參考文獻：

• MariaDB 官方文檔
• MySQL 官方文檔