mcpField
M
mcp-server-mariadb

mcp-server-mariadb

ローカル
github.com/abel9851データベース2086 週間前に更新
リポジトリ

mcp-server-mariadb について

mcp-server-mariadb は、MariaDB データベースへの読み取り専用アクセスを提供する MCP サーバーです。書き込みを行わずに、AI アシスタントからスキーマの確認やデータの照会を行いたい利用者を対象としています。

主な機能

  1. 01スキーマ一覧のリソースとしての公開
  2. 02読み取り専用クエリを実行する query_database ツール
  3. 03uv または uvx による実行と公開版・開発版の設定

活用シーン

  1. 01AI アシスタントによる MariaDB のテーブル構造の確認
  2. 02Claude Desktop からの読み取り専用でのデータ照会
  3. 03開発中のサーバー変更のローカルでのテスト

MCP 対応

本プロジェクトは MCP サーバーであり、スキーマ一覧をリソースとして公開し、query_database ツールで MCP クライアントに読み取り専用クエリを提供します。

#mcp#mariadb#model-context-protocol#mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

インストール方法は未掲載です

このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。

リポジトリ

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

mcp-server-mariadb

mariadb からデータを取得する MCP サーバーの実装です

機能

リソース

データベースのスキーマ一覧を公開します

ツール
  • query_database
    • MariDB に対して読み取り専用の操作を実行します

依存関係

mariadb のインストール
  • mac
    • mariadb のインストール時に、以下の OS エラーが発生する場合があります。 mariadb-connector-c をインストールすると解決できます。

OSError: mariadb_config not found.

      This error typically indicates that MariaDB Connector/C, a dependency which
      must be preinstalled, is not found.
      If MariaDB Connector/C is not installed, see installation instructions
      If MariaDB Connector/C is installed, either set the environment variable
      MARIADB_CONFIG or edit the configuration file 'site.cfg' to set the
       'mariadb_config' option to the file location of the mariadb_config utility.
  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 での使用方法

設定ファイル

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

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

  • /PATH/TO/uv：UV 実行ファイルの完全なパス
  • /YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb：サーバーのソースコードへのパス

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。リポジトリ内の LICENSE ファイルを参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。