MariaDB Reader MCP Server

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）。

設定

このサーバーを使用するには、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
   

ライセンス

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