MariaDB MCP Server

MariaDB / MySQL データベースアクセス MCP サーバー

この MCP サーバーは、MariaDB / MySQL データベースへのアクセスを提供します。

これにより、次のことが可能になります。

• 利用可能なデータベースの一覧
• データベース内のテーブルを一覧表示する
• テーブルスキーマを説明する
• SQLクエリを実行する

セキュリティ機能

• 読み取り専用アクセス デフォルト: SELECT、SHOW、DESCRIBE、EXPLAIN
• クエリ検証: SQLインジェクションを防ぎ、データ変更の試みをブロックします
• クエリタイムアウト: 長時間実行されるクエリがリソースを消費するのを防ぎます
• 行制限: 過剰なデータ返送を防止

インストール

オプション1: ソースからビルドする

2. 環境変数を設定する

サーバーには次の環境変数が必要です。

• MARIADB_HOST: データベースサーバーのホスト名
• MARIADB_PORT: データベースサーバポート（デフォルト: 3306）
• MARIADB_USER: データベースのユーザー名
• MARIADB_PASSWORD: データベースパスワード
• MARIADB_DATABASE: デフォルトのデータベース名（オプション）
• MARIADB_ALLOW_INSERT: 偽
• MARIADB_ALLOW_UPDATE: 偽
• MARIADB_ALLOW_DELETE: 偽
• MARIADB_TIMEOUT_MS: 10000
• MARIADB_ROW_LIMIT: 1000

3. MCP設定に追加

MCP 設定ファイルに次の構成を追加します。

ソースからビルドした場合:

利用可能なツール

データベース一覧

MariaDB / MySQLサーバー上のアクセス可能なすべてのデータベースを一覧表示します。パラメータ: なし

例：

リストテーブル

指定されたデータベース内のすべてのテーブルを一覧表示します。

パラメータ:

• database （オプション）: データベース名（指定されていない場合はデフォルトを使用）

例：

テーブルの説明

特定のテーブルのスキーマを表示します。

パラメータ:

• database （オプション）: データベース名（指定されていない場合はデフォルトを使用）
• table （必須）: テーブル名

例：

クエリ実行

SQL クエリを実行します。

パラメータ:

• query （必須）: SQLクエリ
• database （オプション）: データベース名（指定されていない場合はデフォルトを使用）

例：

テスト

サーバーは MariaDB を自動的にテストし、MariaDB セットアップの機能性を検証します。

トラブルシューティング

問題が発生した場合:

1. サーバーログでエラーメッセージを確認してください
2. MariaDBの資格情報と接続の詳細を確認する
3. MariaDBユーザーに適切な権限があることを確認する
4. クエリが読み取り専用であり、適切にフォーマットされていることを確認してください

インスピレーション https://github.com/rjsalgado/mariadb-mcp-server

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。