Mariadb Mcp Server

🚀 mcp-server-mariadb

mcp-server-mariadb 是一个用于从 MariaDB 检索数据的 MCP 服务器实现，能够帮助用户便捷地与 MariaDB 数据库进行交互，获取所需数据。

🚀 快速开始

在使用 mcp-server-mariadb 前，你需要完成 MariaDB 的安装和相关配置，具体步骤请参考后续的依赖关系和使用说明部分。

✨ 主要特性

资源

• 公开数据库中的表单列表，方便用户快速查看数据库中的可用表单。

工具

• query_database：执行对 MariaDB 的只读操作，确保数据的安全性。

📦 安装指南

安装 MariaDB

• Mac：当安装 MariaDB 时，可能会抛出以下错误：

OSError: mariadb_config未找到。

此错误通常表示必须预先安装的MariaDB Connector/C未被发现。
如果MariaDB Connector/C未安装，请参阅安装说明。
如果MariaDB Connector/C已安装，则可以通过设置环境变量MARIADB_CONFIG，或编辑配置文件'site.cfg'来将'MARIADB_CONFIG'选项设置为mariadb_config实用工具的文件位置。

• 解决方法：
  1. 执行 brew install mariadb-connector-c。
  2. 执行 echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc。
  3. 设置环境变量 export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config。
  4. 再次执行 uv add mariadb。

💻 使用示例

配置文件路径

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json。
• Windows：%APPDATA%\Claude\claude_desktop_config.json。

启用已发布的服务器

{
"mcpServers": {
"mcp_server_mariadb": {
"command": "/PATH/TO/uvx",
"args": [
"mcp-server-mariadb",
"--host",
"${DB_HOST}",
"--port",
"${DB_PORT}",
"--user",
"${DB_USER}",
"--password",
"${DB_PASSWORD}",
"--database",
"${DB_NAME}"
]
}
}
}

启用开发/未发布的服务器

{
"mcpServers": {
"mcp_server_mariadb": {
"command": "/PATH/TO/uv",
"args": [
"--directory",
"/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb",
"run",
"server.py"
],
"env": {
"MARIADB_HOST": "127.0.0.1",
"MARIADB_USER": "USER",
"MARIADB_PASSWORD": "PASSWORD",
"MARIADB_DATABASE": "DATABASE",
"MARIADB_PORT": "3306"
}
}
}
}

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。请参阅仓库中的 LICENSE 文件。