Mariadb MCP Server

🚀 MariaDB/MySQL MCP サーバー

MariaDB/MySQL MCP サーバーは、データベースの管理や操作を容易にするためのサーバーです。このサーバーを使用することで、データベースの作成、表の管理、データの操作などを簡単に行うことができます。

🚀 クイックスタート

このセクションでは、MariaDB/MySQL MCP サーバーの基本的な使い方を説明します。まずはサーバーのインストールから始めましょう。

📦 インストール

1. NPM からのインストール

以下のコマンドを使用して、MariaDB/MySQL MCP サーバーをグローバルにインストールできます。

npm install -g mariadb-mcp-server

2. ソースコードからのビルド

ソースコードからビルドする場合は、以下の手順に従ってください。

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/mariaDB-mcp-server.git
   cd mariaDB-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

🔧 設定

環境変数の設定

サーバーを起動する前に、以下の環境変数を設定してください。

• MARIADB_HOST: データベースのホストアドレス。デフォルトは localhost です。
• MARIADB_PORT: データベースのポート番号。デフォルトは 3306 です。
• MARIADB_USER: データベースのユーザー名。
• MARIADB_PASSWORD: データベースのユーザーパスワード。

設定ファイル

プロジェクトのルートディレクトリにある config.json ファイルを使用して、サーバーの他のパラメータを設定できます。例えば：

{
  "port": 3000,
  "debug": false,
  "logLevel": "info"
}

💻 サーバーの起動

サーバーを起動するには、以下のコマンドを実行します。

npm start

✨ 主な機能

1. データベース管理

• データベースの作成:

  CREATE DATABASE your_database;
  

• データベースの削除:

  DROP DATABASE your_database;
  

• データベースの使用:

  USE your_database;
  

2. 表管理

• 表の作成:

  CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL UNIQUE
  );
  

• 表の削除:

  DROP TABLE users;
  

3. データ操作

• データの挿入:

  INSERT INTO users (username, email) VALUES ('john', 'john@example.com');
  

• データの検索:

  SELECT * FROM users WHERE id = 1;
  

• データの更新:

  UPDATE users SET username = 'johndoe' WHERE id = 1;
  

• データの削除:

  DELETE FROM users WHERE id = 1;
  

💻 使用例

ユーザー表の作成とデータの挿入

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  username VARCHAR(50) NOT NULL,
  email VARCHAR(100) NOT NULL UNIQUE
);

INSERT INTO users (username, email) VALUES ('alice', 'alice@example.com');

ユーザー表の全データの検索

SELECT * FROM users;

🐞 エラー処理

一般的なエラーと解決策

1. 接続タイムアウト

   • データベースサービスが実行中か確認してください。
   • ファイアウォールがポート 3306 をブロックしていないことを確認してください。

2. 権限不足

   • データベースユーザーが十分な権限を持っていることを確認してください。
   • 以下のコマンドを使用して権限を付与します。

     GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'localhost' IDENTIFIED BY 'your_password';
     FLUSH PRIVILEGES;
     

3. 構文エラー

   • SQL 文の構文が正しいことを確認してください。
   • データベース管理ツールを使用してクエリを検証してください。

📚 参考文献

• MariaDB 公式ドキュメント
• MySQL 公式ドキュメント
• Lucas の MySQL MCP サーバー をベースに開発されています。