mcpField
M
mcp-server-mariadb

mcp-server-mariadb

本地服务
github.com/abel9851数据库2086 周前更新
代码仓库

关于 mcp-server-mariadb

mcp-server-mariadb 是一个 MCP 服务，提供对 MariaDB 数据库的只读访问。它面向需要让 AI 助手查询数据库结构与数据的用户，并以只读操作为设计重点。

主要功能

  1. 01以资源形式公开数据库的 schema 列表
  2. 02提供 query_database 工具执行只读查询
  3. 03基于 uv 或 uvx 运行，可通过 PyPI 发布

适用场景

  1. 01让 AI 助手查看 MariaDB 数据库的表结构
  2. 02在 Claude Desktop 中以只读方式查询业务数据
  3. 03开发阶段在本地测试 MCP 服务的修改

MCP 相关

该项目是 MCP 服务，通过 Resources 公开 schema 列表，并通过 query_database 工具向 MCP 客户端提供只读查询能力。

#mcp#mariadb#model-context-protocol#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-server-mariadb

用于从 mariadb 检索数据的 MCP 服务实现

功能

资源

公开数据库中的架构列表

工具
  • query_database
    • 对 MariDB 执行只读操作

依赖项

安装 mariadb
  • mac
    • 安装 mariadb 时， 可能会出现以下操作系统错误。 安装 mariadb-connector-c 即可解决。

OSError: mariadb_config not found.

      This error typically indicates that MariaDB Connector/C, a dependency which
      must be preinstalled, is not found.
      If MariaDB Connector/C is not installed, see installation instructions
      If MariaDB Connector/C is installed, either set the environment variable
      MARIADB_CONFIG or edit the configuration file 'site.cfg' to set the
       'mariadb_config' option to the file location of the mariadb_config utility.
  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。

在 Claude Desktop 中使用

配置文件

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 文件。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。