Mysql MCP

🚀 zaj-MySQL-MCP

このプロジェクトは、MySQLを通じて、直接的にデータベースとの相互作用やビジネスインテリジェンス機能を提供するモデルコンテキストプロトコル（MCP）サーバーの実装です。このサーバーは、SQLクエリの実行、ビジネスデータの分析、およびビジネス洞察レポートの自動生成をサポートしています。

✨ 主な機能

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

📚 ドキュメント

ツール

查询工具

• 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: 分析過程で見つかったすべての洞察を集めた、継続的に更新されるビジネス洞察レポートです。
  • append-insightツールを使用して新しい洞察が追加されると自動的に更新されます。

🔧 技術詳細

このMCPサーバーは、外部のSDKに依存せず、直接モデルコンテキストプロトコルを実装しています。以下のライブラリを使用しています。

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

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

📦 インストール

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

# データベース接続
DB_CONNECTION=mysql

# データベースホスト
DB_HOST=localhost

# データベースポート
DB_PORT=3306

# データベースユーザー名（必須）
DB_USER=your_mysql_username

# データベースパスワード（必須）
DB_PASSWORD=your_mysql_password

# データベース名（必須）
DB_NAME=your_database_name

.env.exampleファイルがテンプレートとして提供されています。これをコピーして編集します。

cp .env.example .env
# 次に.envファイルを編集します

📄 ライセンス

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