mcp-server-mariadb

mcp-server-mariadb

site icon
2025.04.04 0
Python数据库服务数据库
mcp-server-mariadb 是一个用于从 MariaDB 数据库中检索数据的 MCP 服务器实现。它提供了对 MariaDB 数据库的只读操作能力,并能够暴露数据库中的模式列表。
View on GitHub

Overview

基本能力

产品定位

mcp-server-mariadb 是一个专门用于与 MariaDB 数据库交互的 MCP 服务器,旨在提供对数据库的只读访问和数据检索功能。

核心功能

  • 资源暴露:能够暴露数据库中的模式列表。
  • 数据库查询:提供 query_database 工具,用于执行对 MariaDB 的只读操作。

适用场景

  • 需要从 MariaDB 数据库中检索数据的应用场景。
  • 开发过程中需要快速访问和查询数据库信息的场景。

工具列表

  • query_database:用于执行对 MariaDB 数据库的只读操作。

常见问题解答

  • 安装依赖问题:在安装过程中可能会遇到 OSError: mariadb_config not found 错误,这通常是因为缺少 MariaDB Connector/C 依赖。解决方法包括安装 mariadb-connector-c 并设置相应的环境变量。

使用教程

使用依赖

  1. 安装 mariadb-connector-cbash brew install mariadb-connector-c
  2. 更新环境变量: bash echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc
  3. 设置 MARIADB_CONFIG 环境变量: bash export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config

安装教程

  1. 确保已安装所有依赖。
  2. 使用 uv 工具添加 mariadb 服务: bash uv add mariadb

调试方式

  1. 确保 mariadb-connector-c 已正确安装并配置。
  2. 检查环境变量 MARIADB_CONFIG 是否设置正确。
  3. 尝试运行 query_database 工具进行数据库查询测试。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。