MariaDB MCPサーバー

「MariaDB」MCPサーバーは何をするのか？

MariaDB MCPサーバーは、AIアシスタントにMariaDBデータベースへの読み取り専用アクセスを提供するためのツールです。Model Context Protocol (MCP) サーバーとして動作し、AI活用の開発ワークフローから外部MariaDBデータソースへ直接接続できます。この統合により、AIアシスタントはデータベーススキーマの取得や読み取り専用クエリの実行などのタスクを実現し、データ分析・アプリ開発・ビジネスインテリジェンスなどで活用できます。大規模言語モデルとライブデータベースの橋渡し役となり、データベースの整合性を損なうことなく、安全かつ効率的で文脈豊かなやりとりを実現します。

プロンプト一覧

利用可能なドキュメントにはプロンプトテンプレートの記載はありません。

リソース一覧

• スキーマ一覧の公開
  サーバーは接続されたMariaDBデータベース内のスキーマ一覧を公開し、クライアントが利用可能なデータ構造を確認できます。
  (他のリソースは明示的に記載されていません。)

ツール一覧

• query_database
  MariaDBインスタンスに対する読み取り専用操作を実行できます。このツールにより、SELECTクエリを実行し、分析やワークフローへの統合のためにデータを取得できます。

このMCPサーバーのユースケース

• データベース探索
  開発者やデータサイエンティストは、スキーマ情報の取得や読み取り専用クエリを行うことで、MariaDBデータベースの構造を安全に把握できます。

• ビジネスインテリジェンス
  AIアシスタントがライブデータベースに安全にクエリを実行し、ダッシュボードやレポート作成を支援できます。

• アプリケーションデバッグ
  本番データベース内のデータを安全に確認・検証でき、トラブルシューティングや検証作業をサポートします。

• 自動データ分析
  AIツールがデータベースレコードを取得・処理し、統計分析、トレンド抽出、機械学習モデルの学習などに活用できます。

セットアップ方法

Windsurf

利用可能なドキュメントにはWindsurfに関する明示的な手順は記載されていません。

Claude

1. 設定ファイルの場所を特定:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. MCPサーバー設定を追加:
   プレースホルダーを実際の値に置き換え、下記のJSONスニペットを挿入します:

   {
       "mcpServers": {
           "mcp_server_mariadb": {
               "command": "/PATH/TO/uvx",
               "args": [
                   "mcp-server-mariadb",
                   "--host",
                   "${DB_HOST}",
                   "--port",
                   "${DB_PORT}",
                   "--user",
                   "${DB_USER}",
                   "--password",
                   "${DB_PASSWORD}",
                   "--database",
                   "${DB_NAME}"
               ]
           }
       }
   }
   

3. プレースホルダーの置換:
   • /PATH/TO/uvx をuvx実行ファイルのフルパスに更新します。
4. 保存とClaudeの再起動:
   • 変更を保存し、Claude Desktopを再起動してサーバーを有効化します。
5. 接続の検証:
   • サーバーが稼働し、MariaDBインスタンスへ正常に接続されていることを確認します。

開発・未公開サーバーの例:

{
    "mcpServers": {
        "mcp_server_mariadb": {
            "command": "/PATH/TO/uv",
            "args": [
                "--directory",
                "/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb",
                "run",
                "server.py"
            ],
            "env": {
                "MARIADB_HOST": "127.0.0.1",
                "MARIADB_USER": "USER",
                "MARIADB_PASSWORD": "PASSWORD",
                "MARIADB_DATABASE": "DATABASE",
                "MARIADB_PORT": "3306"
            }
        }
    }
}

すべてのパスや認証情報のプレースホルダーは必ず適切に置き換えてください。

Cursor

利用可能なドキュメントにはCursorに関する明示的な手順は記載されていません。

Cline

利用可能なドキュメントにはClineに関する明示的な手順は記載されていません。

APIキーの安全な管理

環境構築時は、機密性の高い認証情報を環境変数で管理してください。例:

"env": {
    "MARIADB_HOST": "127.0.0.1",
    "MARIADB_USER": "USER",
    "MARIADB_PASSWORD": "PASSWORD",
    "MARIADB_DATABASE": "DATABASE",
    "MARIADB_PORT": "3306"
}

値は安全に保管し、設定ファイルに秘密情報をハードコードしないようにしましょう。

フロー内でのMCP利用方法

FlowHuntでのMCP利用

FlowHuntのワークフローにMCPサーバーを組み込むには、MCPコンポーネントをフローに追加し、AIエージェントへ接続します。

MCPコンポーネントをクリックして設定パネルを開き、システムMCP設定セクションで下記のJSONフォーマットでサーバー情報を入力します:

{
  "mcp_server_mariadb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントはこのMCPをツールとして利用でき、全ての機能にアクセス可能となります。"mcp_server_mariadb"は実際のMCPサーバー名に、URLはご自身のMCPサーバーURLに必ず置き換えてください。

概要

以上の表から、MariaDB MCPサーバーはシンプルかつ必要最小限の機能に特化しており、MariaDBデータベースアクセスに本質的な機能を提供しています。プロンプトテンプレートやサンプリングなどの高度なMCP機能は未対応ですが、ツール・リソース・安全な設定などのコア機能はしっかり備えています。読み取り専用データベースサーバーとしては堅実ですが基本的な内容です。

MCPスコア