MCPサーバー - MariaDBとは？

MCPサーバー - MariaDBは、Model Context Protocol (MCP)に基づくツールで、MariaDBデータベースからデータを読み取り、クエリを実行することを目的としています。簡単なAPIインターフェースを通じて、データベース内のテーブルとデータにアクセスできます。

MCPサーバー - MariaDBの使い方は？

設定ファイルでデータベース接続情報を指定すると、APIを簡単に呼び出してデータをクエリできます。データベース操作を詳しく知らなくても、すぐに必要な情報を取得できます。

適用シナリオ

MariaDBデータベースから構造化データを抽出する必要がある企業アプリケーション、データ分析プラットフォーム、およびリアルタイムデータ統合が必要なあらゆるシナリオに適しています。

主な機能

リソースリストデータベース内のすべてのテーブルとその関連情報を表示します。

クエリ実行MariaDBに対して読み取り専用のSQLクエリ操作を実行することをサポートします。

利点と制限

利点

複雑なデータベースクエリのプロセスを簡素化します。

複数のオペレーティングシステムと環境をサポートします。

既存のシステムに容易に統合できます。

制限

読み取り専用のSQLクエリのみをサポートし、データベースを変更することはできません。

MariaDBデータベース環境に依存しています。

使い方

MariaDBドライバーをインストールする

MariaDBクライアントライブラリ（例：mariadb-connector-c）がインストールされていることを確認してください。インストールされていない場合は、ドキュメントを参照してインストールしてください。

MCPサーバーを設定する

設定ファイルを編集して、データベース接続情報を設定します。

MCPサーバーを起動する

MCPサーバーを実行して、リクエストの処理を開始します。

使用例

ケースタイトル：すべてのテーブル名をリストするMCPサーバーを通じて、MariaDBデータベース内のすべてのテーブル名を取得します。

ケースタイトル：特定のユーザーの注文レコードをクエリするユーザー名に基づいて注文情報をフィルタリングします。

よくある質問

インストール中にmariadb_configが見つからない問題をどう解決すればいいですか？

書き込み操作はサポートされていますか？

🚀 mcp-server-mariadb

このプロジェクトは、MariaDBからデータを取得するためのMCPサーバーの実装です。

✨ 主な機能

リソース

データベース内のテーブルリストを表示します。

ツール

query_database
- MariaDB上で読み取り専用操作を実行します。

📦 インストール

MariaDBのインストール

Mac
- MariaDBをインストールする際に、以下のエラーが発生することがあります。 mariadb-connector-cをインストールすることで解決できます。

OSError: mariadb_config未找到。

      这个错误通常表示MariaDB Connector/C，一个必须预先安装的依赖项，
      没有被找到。
      如果MariaDB Connector/C没有安装，请参见安装说明
      如果MariaDB Connector/C已安装，则可以通过设置环境变量MARIADB_CONFIG
      或编辑配置文件'site.cfg'来将'MARIADB_CONFIG'选项设置为mariadb_config实用程序的文件位置。

brew install mariadb-connector-c を実行します。
echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc を実行します。
環境変数 export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config を設定します。
uv add mariadb を再度実行します。

💻 使用例

Claude Desktopの使用

設定ファイルパス

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.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}"
            ]
        }
    }
}

注意：これらのプレースホルダーを実際のパスに置き換えてください。

/PATH/TO/uvx：uvx実行可能ファイルの完全パス

開発/未公開のサーバーを有効にするための設定を追加

{
    "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"
            }
        }
    }
}