MariaDB数据库读取器

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 必须根据实际环境修改对象内的MariaDB连接信息。

开发（修改源代码时）

此存储库包含已构建的文件，因此不必执行以下步骤来使用服务器。源代码（src 目录），要修改并应用更改，请执行以下步骤：

1. 依赖性安装（第一次或 package.json 更改时：
   复制

   npm install
   

2. 修改后构建：
   复制

   npm run build
   

   • 此命令 src 目录中的TypeScript代码 build 编译为目录中的JavaScript代码。
3. （可选）在开发过程中检测更改并自动构建：
   复制

   npm run watch
   

许可证

此项目在“输入许可信息”许可下分发。