mcpField
M
mariadb-mcp-server

mariadb-mcp-server

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

关于 mariadb-mcp-server

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

主要功能

  1. 01以资源形式列出数据库中的 schema
  2. 02提供 query_database 工具
  3. 03仅执行只读操作
  4. 04基于 uvx 运行，可配置 Claude Desktop

适用场景

  1. 01让 AI 助手查询 MariaDB 数据
  2. 02在 Claude Desktop 中浏览数据库结构

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露数据库 schema 资源和 query_database 工具。

#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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。