MariaDB Reader MCP Server

このプロジェクトは、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）。

Related MCP server: MCP MariaDB Server

設定

このサーバーを使用するには、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. 依存関係のインストール（最初の1回またはpackage.json変更時）：

   npm install

2. 修正後のビルド：

   npm run build

   • このコマンドは、 srcディレクトリのTypeScriptコードをbuildディレクトリのJavaScriptコードにコンパイルします。

3. （オプション）開発中の変更の検出と自動ビルド：

   npm run watch

ライセンス

このプロジェクトは、[ライセンス情報の入力]ライセンスの下で配布されます。