MCP Server Mariadb

MCP Server Mariadb

一个用于从MariaDB数据库检索数据的MCP服务器实现

数据库开发者工具 #数据库查询 #MariaDB #MCP服务 #数据检索 .Python

评分 : 2.5分

下载量 : 5.3K

更新时间 : 2025-04-29

什么是MCP服务器-MariaDB？

MCP服务器-MariaDB是一个基于Model Context Protocol (MCP)的工具，旨在从MariaDB数据库中读取和查询数据。它支持通过简单的API接口访问数据库中的表和数据。

如何使用MCP服务器-MariaDB？

通过配置文件指定数据库连接信息后，您可以轻松地调用API来查询数据。无需深入了解数据库操作，即可快速获取所需的信息。

适用场景

适用于需要从MariaDB数据库中提取结构化数据的企业应用、数据分析平台以及任何需要实时数据集成的场景。

主要功能

资源列表

展示数据库中的所有表及其相关信息。

查询执行

支持对MariaDB执行只读SQL查询操作。

优势

简化了复杂数据库查询的过程。

支持多种操作系统和环境。

易于集成到现有系统中。

局限性

仅支持只读SQL查询，无法修改数据库。

依赖于MariaDB数据库环境。

如何使用

安装MariaDB驱动

确保已安装MariaDB客户端库（如mariadb-connector-c）。如果未安装，请参考文档进行安装。

配置MCP服务器

编辑配置文件以设置数据库连接信息。

启动MCP服务器

运行MCP服务器以开始处理请求。

使用案例

案例标题：列出所有表名

通过MCP服务器获取MariaDB数据库中的所有表名。

案例标题：查询特定用户的订单记录

根据用户名筛选订单信息。

常见问题

如何解决安装过程中出现的mariadb_config找不到的问题？

是否支持写入操作？

相关资源

官方文档

详细的使用指南和技术文档。

GitHub代码仓库

开源代码仓库，欢迎贡献和反馈。

🚀 mcp-server-mariadb

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

🚀 快速开始

在使用 mcp-server-mariadb 前，你需要了解它的功能、安装依赖项并进行相应的配置。下面将为你详细介绍。

✨ 主要特性

资源

显示数据库中的表单列表，方便用户快速了解数据库中的数据结构。

工具

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

📦 安装指南

安装 MariaDB

Mac：当安装 MariaDB 时，可能会抛出以下错误。您可以通过安装 mariadb-connector-c 来解决。

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

Duckduckgo MCP Server

DuckDuckGo搜索MCP服务器，为Claude等LLM提供网页搜索和内容抓取服务

Figma Context MCP

Framelink Figma MCP Server是一个为AI编程工具（如Cursor）提供Figma设计数据访问的服务器，通过简化Figma API响应，帮助AI更准确地实现设计到代码的一键转换。

Firecrawl MCP Server

Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器，提供丰富的网页抓取、搜索和内容提取功能。

Minimax MCP Server

MiniMax Model Context Protocol (MCP) 是一个官方服务器，支持与强大的文本转语音、视频/图像生成API交互，适用于多种客户端工具如Claude Desktop、Cursor等。

Edgeone Pages MCP Server

EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务

百度地图MCP Server是国内首个兼容MCP协议的地图服务，提供地理编码、路线规划等10个标准化API接口，支持Python和Typescript快速接入，赋能智能体实现地图相关功能。

Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务，通过Model Context Protocol直接集成到提示中，解决LLM使用过时信息的问题。

Exa MCP Server是一个为AI助手（如Claude）提供网络搜索功能的服务器，通过Exa AI搜索API实现实时、安全的网络信息获取。

AIBase

智启未来，您的人工智能解决方案智库

© 2025AIBase 备案号：闽ICP备08105208号-24