MySQL-MCP

by zajTools

Integrations

  • Uses environment variables for configuration, allowing database credentials to be securely stored and accessed through a .env file.

  • Hosts the repository for the MCP server, enabling users to clone and install the server from GitHub.

  • Provides database interaction capabilities through MySQL, enabling SQL query execution, table management, schema analysis, and business intelligence generation with automatic insights creation.

zaj-MySQL-MCP

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

特徴

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

ツール

クエリツール

  • 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
  1. .env ファイルを作成して設定します。
cp .env.example .env # Edit .env with your database credentials
  1. 依存関係をインストールします:
npm install
  1. サーバーを構築します。
npm run build
  1. サーバーを実行します。
node build/index.js

デモと例

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

  • サンプルデータベース: 顧客、製品、注文、販売データを含む完全な電子商取引データベーススキーマ
  • サンプルクエリ: MCP サーバーのさまざまな機能を示す事前に作成されたクエリ
  • 使用シナリオ: Claude が MySQL データベースと対話する方法の例

デモを試すには:

  1. ステップバイステップの手順についてはデモガイドをご覧ください
  2. セットアップSQLスクリプトを実行してサンプルデータベースを作成します
  3. デモデータベースに接続するようにMCPサーバーを構成する
  4. データについてClaudeに質問してみましょう。

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

ライセンス

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

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

MySQL 接続を通じて SQL クエリ実行、データベース管理、ビジネス インテリジェンス機能を有効にするモデル コンテキスト プロトコル サーバー。

  1. 特徴
    1. ツール
      1. クエリツール
      2. スキーマツール
      3. 分析ツール
    2. リソース
      1. 実装の詳細
        1. 構成
          1. Claude Desktopでの使用
            1. 構築と実行
              1. デモと例
                1. ライセンス

                  Related MCP Servers

                  • -
                    security
                    -
                    license
                    -
                    quality
                    A Model Context Protocol server that enables AI models to interact with MySQL databases, providing tools for querying, executing statements, listing tables, and describing table structures.
                    Last updated 2 months ago
                    MIT License
                  • -
                    security
                    -
                    license
                    -
                    quality
                    A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
                    Last updated 2 months ago
                    Python
                  • -
                    security
                    -
                    license
                    -
                    quality
                    A Model Context Protocol server that enables AI models to interact with MySQL databases through a standardized interface, providing tools for querying, executing commands, and managing database schemas.
                    Last updated 2 months ago
                    JavaScript
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.
                    Last updated 2 months ago
                    3
                    TypeScript
                    MIT License

                  View all related MCP servers

                  ID: 7y0n0wkuak