MCP Server Mariadb Reader

🚀 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
   

📄 ライセンス

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