mysqldb-mcp-server

by burakdirin
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools to connect to MySQL databases and execute SQL queries, with support for multiple queries, returning results in JSON format. Configurable for different MySQL environments and includes optional read-only mode.

mysqldb-mcp-server MCP サーバー

MySQL データベース MCP サーバー プロジェクト。

インストール

uvを使用してパッケージをインストールできます。

uv pip install mysqldb-mcp-server

またはpipを使用します:

pip install mysqldb-mcp-server

コンポーネント

ツール

サーバーは次の 2 つのツールを提供します。

  • connect_database : 特定のMySQLデータベースに接続する
    • databaseパラメータ: 接続するデータベースの名前(文字列)
    • 接続が成功すると確認メッセージを返します
  • execute_query : MySQLクエリを実行する
    • queryパラメータ: 実行する SQL クエリ (文字列)
    • クエリ結果をJSON形式で返します
    • 複数のクエリはセミコロンで区切って送信できます

構成

サーバーは次の環境変数を使用します。

  • MYSQL_HOST : MySQLサーバーのアドレス(デフォルト: "localhost")
  • MYSQL_USER : MySQLユーザー名(デフォルト: "root")
  • MYSQL_PASSWORD : MySQLパスワード(デフォルト: "")
  • MYSQL_DATABASE : 初期データベース(オプション)
  • MYSQL_READONLY : 読み取り専用モード (有効にするには 1/true に設定、デフォルト: false)

クイックスタート

インストール

クロードデスクトップ

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "mysqldb-mcp-server": { "command": "uv", "args": [ "--directory", "/Users/burakdirin/Projects/mysqldb-mcp-server", "run", "mysqldb-mcp-server" ], "env": { "MYSQL_HOST": "localhost", "MYSQL_USER": "root", "MYSQL_PASSWORD": "password", "MYSQL_DATABASE": "[optional]", "MYSQL_READONLY": "true" } } } }
{ "mcpServers": { "mysqldb-mcp-server": { "command": "uvx", "args": [ "mysqldb-mcp-server" ], "env": { "MYSQL_HOST": "localhost", "MYSQL_USER": "root", "MYSQL_PASSWORD": "password", "MYSQL_DATABASE": "[optional]", "MYSQL_READONLY": "true" } } } }

Smithery経由でインストール

Smithery経由で Claude Desktop 用の MySQL データベース統合サーバーを自動的にインストールするには:

npx -y @smithery/cli install @burakdirin/mysqldb-mcp-server --client claude

発達

建築と出版

配布用のパッケージを準備するには:

  1. 依存関係を同期し、ロックファイルを更新します。
uv sync
  1. パッケージディストリビューションをビルドします。
uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

  1. PyPI に公開:
uv publish

注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。

  • トークン: --tokenまたはUV_PUBLISH_TOKEN
  • またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/burakdirin/Projects/mysqldb-mcp-server run mysqldb-mcp-server

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

-
security - not tested
A
license - permissive license
-
quality - not tested

ClaudeとのMySQLデータベース統合を可能にするMCPサーバー。SQLクエリの実行やデータベース接続の管理が可能です。

  1. Installation
    1. Components
      1. Tools
    2. Configuration
      1. Quickstart
        1. Installation
        2. Installing via Smithery
      2. Development
        1. Building and Publishing
        2. Debugging
      ID: qgvfelf3i1