Mariadb MCP Server

MariaDBデータベースからデータを取得するためのMCPサーバーの実装

データベース開発者ツール #データベース接続 #データクエリ #MariaDB .Python

スコア : 2ポイント

ダウンロード数 : 10.6K

更新時間 : 2025-04-23

サイトを開く

MariaDB用MCPサーバーとは？

これは、MariaDBデータベース用に特別に設計されたModel Context Protocolサーバーで、ユーザーが標準インターフェースを通じて安全にデータベースの内容をクエリし、閲覧することを可能にします。データベーススキーマの表示と読み取り専用クエリの実行機能を提供します。

MariaDB用MCPサーバーをどのように使用する？

Claude Desktopアプリを使用してこのサーバーを設定し、接続することができます。その後、安全にMariaDBデータベース内のデータをクエリすることができます。サーバーは、単純なクエリから複雑な分析まで、さまざまなクエリ方式をサポートしています。

適用シナリオ

MariaDBデータベースからデータを取得して分析、レポート作成、または他のシステムに統合する必要があるシナリオに適しています。特に、データ分析やビジネスインテリジェンスアプリケーションに最適です。

主要機能

データベーススキーマブラウジング

MariaDBデータベース内のすべてのテーブルとスキーマ構造を表示する

安全なクエリ実行

読み取り専用のクエリ操作を実行し、意図しないデータの変更を防止する

利点

安全な読み取り専用のデータベースアクセスを提供する

Claude Desktopアプリに簡単に統合できる

標準のMariaDB接続プロトコルをサポートする

制限

MariaDBデータベースのみをサポートする

データベース接続情報を事前に設定する必要がある

読み取り専用のアクセス権限のみを提供する

使い方

依存関係のインストール

MariaDB Connector/Cがインストールされていることを確認してください。これはサーバーを実行するために必要なコンポーネントです。

環境変数の設定

MARIADB_CONFIG環境変数をmariadb_configツールの場所に設定します。

Claude Desktopの設定

Claude Desktopの設定ファイルにサーバーの設定を追加します。

使用例

販売データの取得

販売データベースから直近1か月の販売記録をクエリする

顧客分布の分析

地域ごとの顧客数を集計する

よくある質問

インストール時に「mariadb_config not found」エラーが発生した場合はどうすればいいですか？

サーバーはどのようなタイプのクエリをサポートしていますか？

🚀 mcp-server-mariadb

このプロジェクトは、MariaDBからデータを取得するためのMCPサーバーの実装です。MariaDBとの接続を通じて、データベース内の情報を効率的に取得できます。

🚀 クイックスタート

このMCPサーバーを使用することで、MariaDBからのデータ取得が容易になります。以下のセクションでは、主な機能、インストール方法、使用例などを説明します。

✨ 主な機能

リソース

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

ツール

query_database
- MariaDBに対する読み取り専用操作を実行します。

📦 インストール

MariaDBのインストール

Mac
- MariaDBをインストールする際、以下のエラーが発生する場合があります。
```
OSError: mariadb_config未找到。

    此错误通常表示必须预先安装的MariaDB Connector/C未被发现。
    如果MariaDB Connector/C未安装，请参阅安装说明。
    如果MariaDB Connector/C已安装，则可以通过设置环境变量MARIADB_CONFIG，或编辑配置文件'site.cfg'来将'MARIADB_CONFIG'选项设置为mariadb_config实用工具的文件位置。
```
- 解決策：
  1. brew install mariadb-connector-c を実行します。
  2. echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc を実行します。
  3. 環境変数 export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config を設定します。
  4. 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"
            }
        }
    }
}