Abel9851 MCP Server Mariadb

MariaDBデータベースからデータを取得するためのMCPサーバーの実装で、データベースクエリとスキーマ一覧機能を提供します

データベース開発者ツール #データベース接続 #データ照会 #MariaDB .Python

スコア : 2ポイント

ダウンロード数 : 5.0K

更新時間 : 2025-04-29

サイトを開く

MariaDB用MCPサーバーとは？

これは、MariaDBデータベース向けに特別に設計されたMCPプロトコルサーバーで、ユーザーが標準化されたプロトコルを通じてデータベース内のデータを照会および取得できます。データベーススキーマの一覧表示と読み取り専用クエリの実行機能を提供します。

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

Claude Desktopの設定ファイルを設定することでこのサーバーを有効にするか、ソースコードを直接実行して開発テストを行うことができます。サーバーは、正常に動作するためにMariaDBデータベースインスタンスに接続する必要があります。

適用シナリオ

MariaDBデータベースから直接アクセスすることなく安全にデータを取得する必要があるシナリオ、特にデータベースクエリ機能を他のアプリケーションに統合する必要がある場合に適しています。

主な機能

データベーススキーマの閲覧

データベース内のすべての利用可能なスキーマの一覧を提供します

安全なクエリ

読み取り専用のクエリ操作を実行し、データベースの安全性を確保します

利点

標準化されたデータアクセスインターフェイスを提供する

読み取り専用操作によりデータベースの安全性を確保する

既存のアプリケーションに容易に統合できる

制限

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

現在は読み取り専用機能のみを提供する

MariaDBコネクタを事前にインストールする必要がある

使い方

依存関係のインストール

MariaDB Connector/Cがインストールされていることを確認してください。MacではHomebrewを使用してインストールできます。

環境変数の設定

サーバーがMariaDBコネクタを見つけることができるように、必要な環境変数を設定します。

Claude Desktopの設定

Claude Desktopの設定ファイルを変更してMCPサーバーを有効にします。

使用例

データ分析ツールへの統合

MCPサーバーをデータ分析ツールに統合し、資格情報を公開することなく本番データベースに安全にアクセスします

開発環境の設定

開発環境でMCPサーバーを使用してローカルのテストデータベースに接続します

よくある質問

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

開発環境をどのように設定する？

どのようなデータベース操作がサポートされていますか？

🚀 mcp-server-mariadb

MariaDBからデータを取得するためのMCPサーバーの実装です。このサーバーは、MariaDBとのデータやり取りを容易にし、特定の操作を効率的に実行できるようにします。

✨ 主な機能

リソース

データベース内のテーブルリストが公開されています。

ツール

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

📦 インストール

依存関係のインストール

MariaDBのインストール

Macでインストールする際、以下のエラーが発生することがあります。

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