Zaj MySQL

🚀 MySQL-MCP サーバー実装

このサーバーは、外部の SDK に依存することなく、モデルコンテキストプロトコル (MCP) を直接実装しています。データベースのやり取りとビジネスインテリジェンス機能を提供し、MySQL を通じて SQL クエリを実行し、データ分析を行い、自動的にビジネス洞察メモを生成します。

✨ 主な機能

• MySQL データベースに対して SQL クエリを実行する
• データベーステーブルの作成と管理
• データテーブルの構造分析
• ビジネス洞察の生成と保存
• 継続的に更新されるビジネス洞察メモへのアクセス

📦 ツールセット

クエリツール

• read_query：SELECT クエリを実行してデータベースからデータを読み取ります。

  • 入力：query（文字列）—— 実行する SELECT SQL クエリ文
  • 戻り値：オブジェクト配列形式のクエリ結果

• write_query：INSERT、UPDATE、または DELETE 操作を実行します。

  • 入力：query（文字列）—— 実行する変更 SQL 文
  • 戻り値：{ affected_rows: 件数 }

• create_table：データベースに新しいテーブルを作成します。

  • 入力：query（文字列）—— CREATE TABLE の SQL 文
  • 戻り値：テーブルが作成されたことを確認するメッセージ

アーキテクチャツール

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

  • 入力：なし
  • 戻り値：テーブル名の配列

• describe_table：特定のテーブルのアーキテクチャ情報を表示します。

  • 入力：table_name（文字列）—— 説明するテーブル名
  • 戻り値：列定義とその名前および型を含む配列

分析ツール

• append_insight：新しいビジネス洞察をメモリソースに追加します。
  • 入力：insight（文字列）—— データ分析で見つかったビジネス洞察
  • 戻り値：洞察が追加されたことを確認するメッセージ
  • memo://insights リソースの更新をトリガーします

📚 リソース

サーバーは以下のリソースを公開しています：

• memo://insights：分析過程で見つかったすべての洞察を集約した、継続的に更新されるビジネス洞察メモ。新しい洞察が追加されると自動的に更新されます。

🔧 技術詳細

この MCP サーバーは、JSON-RPC 2.0 プロトコルを直接使用して Claude と通信し、ツールリスト、リソースリスト、およびツール実行リクエストを処理します。その実装は以下のライブラリに依存しています：

• mysql2：MySQL データベース接続用
• yargs：コマンドライン引数の解析用
• readline：標準入出力の処理用

🛠️ 設定

サーバーは環境変数を使用して設定されます。ルートディレクトリに .env ファイルを作成し、以下の内容を含める必要があります：

# データベース設定
DB_HOST=データベースホストアドレス  
DB_PORT=データベースポート番号  
DB_USER=データベースユーザー名  
DB_PASSWORD=データベースパスワード  
DB_NAME=使用するデータベース名

.env.example ファイルがテンプレートとして提供されており、ユーザーはこれをコピーして必要に応じて変更できます。

👥 Claude Desktop との統合

cline_mcp_settings.json ファイルにサーバー設定を追加します：

{
  "servers": [
    {
      "name": "MySQL-MCP",
      "command": "node server.js", // 起動コマンド
      "parameters": {} // オプションパラメータ
    }
  ]
}

ユーザーは .env ファイルを使用して機密情報を管理し、設定の安全性を確保します。

🚧 構築と実行

1. リポジトリのクローン

   git clone https://github.com/username/mysql-mcp.git
   cd mysql-mcp
   

2. 依存関係のインストール

   npm install
   

3. サービスエンドポイントの構築

   npm run build
   

4. サーバーの起動

   npm start
   

このプロジェクトには、ユーザーがすぐに使い始められるように、サンプルデータベースとクエリが用意されています。

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で提供されています。