mcpField
M
mariadb-mcp-server

mariadb-mcp-server

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

mariadb-mcp-server について

mariadb-mcp-server は、MariaDB への読み取り専用アクセスを提供する MCP サーバーです。読み取り操作に限定して、LLM から MariaDB のデータを照会したい場合に適しています。

主な機能

  1. 01データベースのスキーマ一覧をリソースとして公開
  2. 02query_database ツールの提供
  3. 03読み取り専用操作のみの実行
  4. 04uvx による実行と Claude Desktop 設定への対応

活用シーン

  1. 01AI アシスタントによる MariaDB データの照会
  2. 02Claude Desktop からのデータベース構造の参照

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 つのサーバーを複数のクライアントで再利用できます。