金大哥 - mariadb-mcp-server MCP 详情

article

README

🚀 MariaDB/MySQL MCP 服务器

本项目是一个 MariaDB/MySQL MCP 服务器，可帮助用户便捷地进行数据库管理、表管理以及数据操作等功能。

🚀 快速开始

要使用 MariaDB/MySQL MCP 服务器，您可以按照以下步骤进行操作：

安装服务器。
进行相关配置。
启动服务器。

下面将为您详细介绍每个步骤。

📦 安装指南

1. 从 NPM 安装

您可以使用以下命令将 MariaDB/MySQL MCP 服务器安装到您的系统中：

npm install -g mariadb-mcp-server

2. 从源代码构建

如果您希望从源代码构建，请按照以下步骤操作：

克隆仓库：

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

安装依赖项：

npm install

构建项目：

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;

🔧 技术细节

错误处理

常见错误及解决方案

连接超时
- 检查数据库服务是否正在运行。
- 确保防火墙没有阻止端口 3306。
权限不足
- 确保数据库用户拥有足够的权限。
- 使用以下命令授予权限：

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

语法错误
- 检查 SQL 语句的语法是否正确。
- 使用数据库管理工具验证查询。

📄 许可证

本项目基于 Lucas 的 MySQL MCP 服务器开发，更多信息请参考以下参考文献：

mariadb-mcp-server