zaj-MySQL-MCP

MySQLを介してデータベースとの連携とビジネスインテリジェンス機能を提供する、モデルコンテキストプロトコル（MCP）サーバー実装です。このサーバーは、SQLクエリの実行、ビジネスデータの分析、ビジネスインサイトメモの自動生成を可能にします。

特徴

• MySQLデータベースに対してSQLクエリを実行する

• データベーステーブルの作成と管理

• データベーススキーマを分析する

• ビジネスインサイトを生成して保存する

• 継続的に更新されるビジネスインサイトメモにアクセスします

Related MCP server: Database MCP Server

ツール

クエリツール

• read_query : データベースからデータを読み込むためのSELECTクエリを実行する

  • 入力: query (文字列) - 実行するSELECT SQLクエリ

  • 戻り値: クエリ結果をオブジェクトの配列として返します

• write_query : INSERT、UPDATE、または DELETE クエリを実行する

  • 入力: query (文字列) - SQL変更クエリ

  • 戻り値: { affected_rows: number }

• create_table : データベースに新しいテーブルを作成する

  • 入力: query (文字列) - CREATE TABLE SQL ステートメント

  • 戻り値: テーブル作成の確認

スキーマツール

• list_tables : データベース内のすべてのテーブルのリストを取得します

  • 入力不要

  • 戻り値: テーブル名の配列

• describe_table : 特定のテーブルのスキーマ情報を表示する

  • 入力: table_name (文字列) - 記述するテーブルの名前

  • 戻り値: 名前と型を持つ列定義の配列

分析ツール

• append_insight : メモリソースに新しいビジネスインサイトを追加する

  • 入力: insight (文字列) - データ分析から発見されたビジネスインサイト

  • 戻り値: 洞察力追加の確認

  • memo://insights リソースの更新をトリガーします

リソース

サーバーは単一のリソースを公開します:

• memo://insights : 分析中に発見された洞察を集約した、継続的に更新されるビジネス洞察メモ

  • 追加インサイトツールで新しいインサイトが発見されると自動更新されます

実装の詳細

このMCPサーバーは、外部SDKへの依存なしに、モデルコンテキストプロトコルを直接実装します。以下のものを使用します。

• mysql2 : MySQLデータベース接続用

• yargs : コマンドライン引数の解析用

• readline : stdin/stdout通信を処理するため

サーバーは、Claude との通信に JSON-RPC 2.0 プロトコルに従い、ツールのリスト、リソースのリスト、およびツールの実行の要求を処理します。

構成

MySQL MCPサーバーは設定に環境変数を使用します。ルートディレクトリに以下の変数を含む.envファイルを作成してください。

# Database Connection
DB_CONNECTION=mysql

# Database Host
DB_HOST=localhost

# Database Port
DB_PORT=3306

# Database Username (required)
DB_USER=your_mysql_username

# Database Password (required)
DB_PASSWORD=your_mysql_password

# Database Name (required)
DB_NAME=your_database_name

テンプレートとして.env.exampleファイルが提供されています。これを.envにコピーし、値を更新してください。

cp .env.example .env
# Then edit .env with your database credentials

Claude Desktopでの使用

cline_mcp_settings.jsonにサーバーを追加します。

"mcpServers": {
  "mysql": {
    "command": "node",
    "args": [
      "/path/to/zaj_MySQL_MCP/build/index.js"
    ],
    "disabled": false,
    "autoApprove": []
  }
}

データベース資格情報は、コマンドライン引数ではなく、 .envファイルを通じて構成されることに注意してください。

構築と実行

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

git clone https://github.com/zajTools/zaj-MySQL-MCP.git
cd zaj-MySQL-MCP

2. .env ファイルを作成して設定します。

cp .env.example .env
# Edit .env with your database credentials

3. 依存関係をインストールします:

npm install

4. サーバーを構築します。

npm run build

5. サーバーを実行します。

node build/index.js

デモと例

MySQL MCP サーバーを使い始める際に役立つサンプル資料を用意しました。

• サンプルデータベース: 顧客、製品、注文、販売データを含む完全な電子商取引データベーススキーマ

• サンプルクエリ: MCP サーバーのさまざまな機能を示す事前に作成されたクエリ

• 使用シナリオ: Claude が MySQL データベースと対話する方法の例

デモを試すには:

1. ステップバイステップの手順についてはデモガイドをご覧ください

2. セットアップSQLスクリプトを実行してサンプルデータベースを作成します

3. デモデータベースに接続するようにMCPサーバーを構成する

4. データについてClaudeに質問してみましょう。

これらの例は、Claude を MySQL データベースで使用する可能性を示すために設計されていますが、MCP サーバーはアクセスできる任意の MySQL データベースで動作します。

ライセンス

この MCP サーバーは MIT ライセンスに基づいてライセンスされます。