MariaDB MCP Server by CData

mariadb-mcp-server-by-cdata

MariaDB 用 CData のモデル コンテキスト プロトコル (MCP) サーバー

:heavy_exclamation_mark: このプロジェクトは読み取り専用のMCPサーバーを構築します。完全な読み取り、書き込み、更新、削除、およびアクション機能と簡単なセットアップについては、無料の[CData MCP Server for MariaDB (beta)]( https://www.cdata.com/download/download.aspx?sku=SRZK-V &type=beta) をご確認ください。

目的

この読み取り専用 MCP サーバーは、LLM (Claude Desktop など) がCData JDBC Driver for MariaDBでサポートされている MariaDB のライブ データをクエリできるようにするために作成されました。

CData JDBC ドライバーは、MariaDB をリレーショナル SQL モデルとして公開して接続します。

このサーバーは、そのドライバーをラップし、シンプルな MCP インターフェースを通じて MariaDB データを利用できるようにします。そのため、LLM は自然言語で質問することでライブ情報を取得できます。SQL は必要ありません。

セットアップガイド

1. リポジトリをクローンします。
   git clone https://github.com/cdatasoftware/mariadb-mcp-server-by-cdata.git cd mariadb-mcp-server-by-cdata
2. サーバーを構築します。
   mvn clean install
   これにより、JAR ファイル CDataMCP-jar-with-dependencies.jar が作成されます。
3. {source} 用の CData JDBC ドライバーをダウンロードしてインストールします: https://www.cdata.com/drivers/mariadb/download/jdbc
4. CData JDBC ドライバーのライセンスを取得します。
   • 通常、インストール ディレクトリ内のlibフォルダに移動します。
     • (Windows) C:\Program Files\CData\CData JDBC Driver for MariaDB\
     • (Mac/Linux) /Applications/CData JDBC Driver for MariaDB/
   • java -jar cdata.jdbc.mariadb.jar --licenseコマンドを実行します。
   • 名前、メールアドレス、および「TRIAL」（またはライセンス キー）を入力します。
5. データ ソース (Salesforce の例) への接続を構成します。
   • java -jar cdata.jdbc.mariadb.jarコマンドを実行して、接続文字列ユーティリティを開きます。
   • 接続文字列を設定し、「接続テスト」をクリックします

     **注:**データ ソースが OAuth を使用する場合は、ブラウザーで認証する必要があります。

   • 成功したら、後で使用するために接続文字列をコピーします。
6. 次のプロパティと形式を使用して、JDBC 接続用の.prpファイル (例: mariadb.prp ) を作成します。
   • プレフィックス- 公開されるツールに使用されるプレフィックス
   • ServerName - サーバーの名前
   • ServerVersion - サーバーのバージョン
   • DriverPath - JDBC ドライバの JAR ファイルへのフルパス
   • DriverClass - JDBC ドライバー クラスの名前 (例: cdata.jdbc.mariadb.MariaDBDriver)
   • JdbcUrl - CData JDBC ドライバーを使用してデータに接続するための JDBC 接続文字列 (上記からコピー)
   • テーブル- すべてのデータにアクセスするには空白のままにしておきます。そうでない場合は、アクセスを作成するテーブルを明示的に宣言できます。
     Prefix=mariadb ServerName=CDataMariaDB ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.mariadb.jar DriverClass=cdata.jdbc.mariadb.MariaDBDriver JdbcUrl=jdbc:mariadb:InitiateOAuth=GETANDREFRESH; Tables=

Claude Desktopでサーバーを使用する

1. 新しいMCPサーバーを追加するには、以下の形式でClaude Desktop用の設定ファイル（claude_desktop_config.json）を作成してください。ファイルが既に存在する場合は、設定ファイルのmcpServersにエントリを追加してください。ウィンドウズ
   { "mcpServers": { "{classname_dash}": { "command": "PATH\\TO\\java.exe", "args": [ "-jar", "PATH\\TO\\CDataMCP-jar-with-dependencies.jar", "PATH\\TO\\mariadb.prp" ] }, ... } }
   Linux/Mac
   { "mcpServers": { "{classname_dash}": { "command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/mariadb.prp" ] }, ... } }
   必要に応じて、設定ファイルを適切なディレクトリ（例としてClaude Desktop）にコピーします**。Windows**
   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json
   Linux/Mac
   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'
2. クライアント (Claude Desktop) を実行または更新します。

注: MCP サーバーを表示するには、Claude デスクトップ クライアントを完全に終了して再度開く必要がある場合があります。

サーバーの実行

1. 次のコマンドを実行して、MCPサーバーを単独で実行します。
   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

**注意:**サーバーはstdioを使用するため、サーバーと同じマシン上で実行されるクライアントでのみ使用できます。

使用状況の詳細

MCPサーバーの設定が完了すると、AIクライアントは組み込みツールを使用して基盤データの読み取り、書き込み、更新、削除を行えるようになります。通常、ツールを明示的に呼び出す必要はありません。クライアントに基盤データシステムに関する質問に答えてもらうだけで済みます。例えば、以下のようになります。

• 「私がクローズした商談とアカウント業界との相関関係は何ですか？」
• 「SUPPORT プロジェクトにはオープンチケットがいくつありますか？」
• 「今日のカレンダーイベントを教えていただけますか？」

利用可能なツールとその説明のリストは次のとおりです。

ツールと説明

以下の定義では、 {servername}構成ファイル内の MCP サーバーの名前を指します (例: 上記の{classname_dash} )。

• {servername}_get_tables - データソースで利用可能なテーブルのリストを取得します。テーブルで利用可能な列の一覧を取得するには、 {servername}_get_columnsツールを使用します。ツールの出力はCSV形式で返され、最初の行には列ヘッダーが含まれます。
• {servername}_get_columns - テーブルの列リストを取得します。利用可能なテーブルのリストを取得するには、 {servername}_get_tablesツールを使用してください。ツールの出力はCSV形式で返され、最初の行には列ヘッダーが含まれます。
• {servername}_run_query - SQL SELECTクエリを実行する

トラブルシューティング

1. Claude Desktop に CData MCP Server が表示されない場合は、Claude Desktop が完全に終了していることを確認してください (Windows: タスクマネージャー、Mac: アクティビティモニターを使用)
2. Claude Desktop がデータを取得できない場合は、接続が正しく設定されていることを確認してください。接続文字列ビルダーを使用して接続文字列を作成し（上記参照）、その接続文字列をプロパティファイル（.prp）にコピーしてください。
3. データ ソースへの接続に問題がある場合は、 CData サポート チームにお問い合わせください。
4. MCP サーバーの使用中に問題が発生した場合、またはその他のフィードバックがある場合は、 CData コミュニティに参加してください。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

サポートされているすべてのソース