🚀 mcp-server-mariadb
mcp-server-mariadb 是一个用于从 MariaDB 中获取数据的 MCP 服务器实现，能帮助用户便捷地与 MariaDB 数据库进行交互。
✨ 主要特性
资源
- 数据库中的表单列表公开可用，方便用户快速查看和获取相关数据。
工具
- query_database：可执行 MariaDB 上的只读操作，为数据查询提供了便利。
📦 安装指南
安装 MariaDB
在 Mac 上安装时，可能会遇到以下错误：
OSError: mariadb_config未找到。
此错误通常表示必须预安装的 MariaDB Connector/C 未被发现。
如果 MariaDB Connector/C 尚未安装，请参阅安装说明。
如果已安装 MariaDB Connector/C，则可以通过设置环境变量 MARIADB_CONFIG 或编辑配置文件'site.cfg'将'mariadb_config'选项设置为 MariaDB_Config 实用工具的位置。
解决方法如下：
- 执行
brew install mariadb-connector-c - 执行
echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc - 设置环境变量
export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config - 再次执行
uv add mariadb
📚 详细文档
与 Claude Desktop 一起使用
配置文件路径
- 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}"
]
}
}
}
注意：将这些占位符替换为实际路径：
/PATH/TO/uvx：uvx 可执行文件的完整路径
将此配置添加以启用开发/未发布的服务器
{
"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"
}
}
}
}
注意：将这些占位符替换为实际路径：
/PATH/TO/uv：UV 可执行文件的完整路径/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb：服务器源代码路径
📄 许可证
此 MCP 服务器根据 MIT 许可证发布。请参阅存储库中的 LICENSE 文件以获取详细信息。