MariaDB MCP 服务器

MariaDB / MySQL 数据库访问 MCP 服务器

该 MCP 服务器提供对 MariaDB / MySQL 数据库的访问。

它允许您：

列出可用的数据库
列出数据库中的表
描述表模式
执行 SQL 查询

安全功能

只读访问权限默认值：SELECT、SHOW、DESCRIBE 和 EXPLAIN
查询验证：防止 SQL 注入并阻止任何数据修改尝试
查询超时：防止长时间运行的查询消耗资源
行限制：防止返回过多的数据

安装

选项 1：从源代码构建

# Clone the repository
git clone https://github.com/bretoreta/mariadb-mcp-server.git
cd mariadb-mcp-server

# Install dependencies and build
pnpm install
pnpm run build

2.配置环境变量

服务器需要以下环境变量：

MARIADB_HOST：数据库服务器主机名
MARIADB_PORT：数据库服务器端口（默认值：3306）
MARIADB_USER：数据库用户名
MARIADB_PASSWORD：数据库密码
MARIADB_DATABASE：默认数据库名称（可选）
MARIADB_ALLOW_INSERT：false
MARIADB_ALLOW_UPDATE：false
MARIADB_ALLOW_DELETE：false
MARIADB_TIMEOUT_MS：10000
MARIADB_ROW_LIMIT：1000

3. 添加到 MCP 设置

将以下配置添加到您的 MCP 设置文件：

如果你从源代码构建：

{
  "mcpServers": {
    "mariadb": {
      "command": "node",
      "args": ["/path/to/mariadb-mcp-server/dist/index.js"],
      "env": {
        "MARIADB_HOST": "your-host",
        "MARIADB_PORT": "3306",
        "MARIADB_USER": "your-user",
        "MARIADB_PASSWORD": "your-password",
        "MARIADB_DATABASE": "your-default-database",
        "MARIADB_ALLOW_INSERT": "false",
        "MARIADB_ALLOW_UPDATE": "false",
        "MARIADB_ALLOW_DELETE": "false",
        "MARIADB_TIMEOUT_MS": "10000",
        "MARIADB_ROW_LIMIT": "1000",
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

列出数据库

列出 MariaDB / MySQL 服务器上所有可访问的数据库。参数：无

例子：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "list_databases"
  }
}

列表表

列出指定数据库中的所有表。

参数：

database （可选）：数据库名称（如果未指定则使用默认值）

例子：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "list_tables",
    "database": "my_database_name"
  }
}

描述表

显示特定表的模式。

参数：

database （可选）：数据库名称（如果未指定则使用默认值）
table （必填）：表名

例子：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "describe_table",
    "database": "my_database_name"
  }
}

执行查询

执行 SQL 查询。

参数：

query （必需）：SQL 查询
database （可选）：数据库名称（如果未指定则使用默认值）

例子：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "execute_query",
    "query": "SELECT * FROM my_table LIMIT 10"
  }
}

测试

服务器会自动测试 MariaDB 以验证您的 MariaDB 设置的功能：

故障排除

如果您遇到问题：

检查服务器日志中的错误消息
验证您的 MariaDB 凭据和连接详细信息
确保您的 MariaDB 用户具有适当的权限
检查您的查询是否为只读且格式正确

灵感 https://github.com/rjsalgado/mariadb-mcp-server

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

MariaDB MCP Server

Integrations