mcp_server_mariadb_reader

🚀 MariaDB 读者 MCP 服务器

本项目是一款用于探索和与 MariaDB 数据库进行交互的 Model Context Protocol (MCP) 服务器。它为诸如 Cline 之类的 AI 助手提供了访问 MariaDB 数据库并检索信息的工具，极大地提升了数据交互的便捷性。

🚀 快速开始

要使用此服务器，请克隆 GitHub 仓库，并在 MCP 客户端（例如 VS Code 扩展程序）的设置文件中注册服务器信息。此存储库包含预构建的执行文件 (build/index.js)，因此无需进行额外的构建步骤。

✨ 主要特性

此 MCP 服务器提供以下功能：

• list_databases：返回所有可访问的数据库列表。
• list_tables：返回指定数据库中的所有表的列表。
  • 输入：database（字符串，必需）—— 要查询表列表的数据库名称。
• get_table_schema：返回指定表的模式（列定义）。
  • 输入：
    • database（字符串，必需）—— 表所属的数据库名称。
    • table（字符串，必需）—— 要查询模式的表名称。
• query_table：从指定表中查询数据。默认返回前 100 行。
  • 输入：
    • database（字符串，必需）—— 表所属的数据库名称。
    • table（字符串，必需）—— 要查询数据的表名称。
    • limit（数字，可选）—— 返回的最大行数（默认值：100）。

📦 安装指南

克隆仓库

git clone https://github.com/moosin76/mcp_server_mariadb_reader.git

修改 MCP 设置文件

设置示例：

{
  "mcpServers": {
    "mcp_server_mariadb_reader": {
      "command": "node",
      "args": ["<克隆仓库的实际路径>/build/index.js"], // 克隆仓库中 build/index.js 文件的路径
      "env": {
        "MARIADB_HOST": "YOUR_DB_HOST",         // MariaDB 服务器地址
        "MARIADB_PORT": "YOUR_DB_PORT",         // MariaDB 端口号（例如："3306"）
        "MARIADB_USER": "YOUR_DB_USER",         // MariaDB 用户名
        "MARIADB_PASSWORD": "YOUR_DB_PASSWORD", // MariaDB 密码
        "MARIADB_DATABASE": "YOUR_DEFAULT_DB"   // （可选）默认数据库名称
      },
      "disabled": false,
      "autoApprove": []
    }
    // 其他 MCP 服务器设置...
  }
}

注意：

• 将 <克隆仓库的实际路径> 替换为实际克隆的本地路径。（例如：C:/Users/YourUser/Documents/GitHub/mcp_server_mariadb_reader）
• 修改 env 对象中的占位符，如 YOUR_DB_HOST 等。

🔧 技术细节

开发步骤

若要进行源代码修改，请执行以下步骤：

1. 安装依赖项：

npm install

2. 构建项目：

npm run build

3. 使用实时监控（可选）：

npm run watch

📄 许可证

此项目在 [许可证信息待补充] 下分发。