MariaDB/MySQL MCP 服务器

安装指南

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 语句的语法是否正确。
   • 使用数据库管理工具验证查询。

参考文献

• MariaDB 官方文档
• MySQL 官方文档
• 基于 Lucas 的 MySQL MCP 服务器 开发