MariaDB 读者 MCP 服务器

这个项目是一个用于探索和交互 MariaDB 数据库的 Model Context Protocol (MCP) 服务器。该服务器为像 Cline 这样的 AI 助手提供了工具，使其能够访问 MariaDB 数据库并检索信息。

功能

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

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

设置

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

1. 克隆仓库:

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

2. 修改 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
   

许可证

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