プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Read Only Local Mysql MCP Server

✓ hove.capital

作者:hovecapitalバージョン 0.1.1i★ 7iパソコンで動く公式サイト ↗
レジストリ名capital.hove/read-only-local-mysql-mcp-server

インストール方法

What it does

MCP server for read-only MySQL database queries in Claude Desktop

  • Connects パソコンで動く
  • Account or key No key needed
  • Category データベース・データセット

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6381 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6051 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2361 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気11/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア23/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Read Only Local Mysql MCP Server をインストールして。https://mcp.popnx.com/i/capital-hove-read-only-local-mysql-mcp-server.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Read Only Local Mysql MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "read-only-local-mysql": { "command": "npx", "args": [ "-y", "@hovecapital/read-only-mysql-mcp-server" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Read Only Local Mysql MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "read-only-local-mysql": {
          "command": "npx",
          "args": [
            "-y",
            "@hovecapital/read-only-mysql-mcp-server"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Read Only Local Mysql MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Read Only Local Mysql MCP Server を使っていると言うか、回答に Read Only Local Mysql MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Read Only Local Mysql MCP Server につなげません

Read Only Local Mysql MCP Server はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Read Only Local Mysql MCP Server につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · データベース・データセット の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Read Only Local Mysql MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user read-only-local-mysql -- npx -y @hovecapital/read-only-mysql-mcp-server 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Read Only Local Mysql MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user read-only-local-mysql -- npx -y @hovecapital/read-only-mysql-mcp-server
  4. Claude Code で /mcp と入力

    Read Only Local Mysql MCP Server が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Read Only Local Mysql MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Read Only Local Mysql MCP Server を使っていると言うか、回答に Read Only Local Mysql MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Read Only Local Mysql MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "read-only-local-mysql": { "command": "npx", "args": [ "-y", "@hovecapital/read-only-mysql-mcp-server" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Read Only Local Mysql MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Read Only Local Mysql MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Read Only Local Mysql MCP Server を使っていると言うか、回答に Read Only Local Mysql MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Read Only Local Mysql MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "read-only-local-mysql": { "type": "stdio", "command": "npx", "args": [ "-y", "@hovecapital/read-only-mysql-mcp-server" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Read Only Local Mysql MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Read Only Local Mysql MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Read Only Local Mysql MCP Server を使っていると言うか、回答に Read Only Local Mysql MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Read Only Local Mysql MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user read-only-local-mysql -- npx -y @hovecapital/read-only-mysql-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "read-only-local-mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "read-only-local-mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "read-only-local-mysql": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hovecapital/read-only-mysql-mcp-server"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
233/週
確認済みドメイン
✓ hove.capital
接続方法
パソコンで動く
最新バージョンi
0.1.1
レジストリ公開日i
2026年2月17日
コードの最終更新i
2026年11月13日
作者
hovecapital
パッケージ
npm: @hovecapital/read-only-mysql-mcp-server
ウェブサイト
hove.capital
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン hove.capital で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:6 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @hovecapital/read-only-mysql-mcp-server@0.1.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/capital-hove-read-only-local-mysql-mcp-server.svg)](https://mcp.popnx.com/en/servers/capital-hove-read-only-local-mysql-mcp-server)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

データベース・データセットのほかのサーバーとの比較i

  • このカテゴリのほかの1235件のうち91%よりスターが多い
  • このカテゴリのほかの1235件のうち3%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1235件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Read Only Local Mysql MCP Serverは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は6 日前、最新バージョン(0.1.1)がレジストリに届いたのは9 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:QueryWeaver, Supabase, Neon, DBCode, Keboola MCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Supabase

MCP server for interacting with the Supabase platform

作者:supabase広く使われている↓ 24.6万/週★ 3018 リポジトリ全体のスター昨日更新

パソコンでもクラウドでも✓ 提供元 · supabase.com

Neon

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

作者:neondatabase成長中★ 66613 日前更新

クラウドで動く✓ 提供元 · neon.com

DBCode

Query and explore 100+ databases through your DBCode connections.

作者:dbcodeio初期↓ 118/週★ 368 リポジトリ全体のスター2 か月前更新

パソコンで動く✓ 提供元 · dbcode.io

Keboola MCP

Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

作者:keboola成長中↓ 1421/週★ 843 日前更新

パソコンでもクラウドでも✓ 提供元 · keboola.com
似たものと比べる
これ
Read Only Local Mysql MCP Server
QueryWeaverSupabaseNeonDBCodeKeboola MCP
動く場所パソコンにインストールが必要パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要パソコンにインストールが必要クラウドでもパソコンにインストールでも使える
キーが必要いいえいいえはいいいえいいえいいえ
Claude で + から追加いいえいいえはいはいいいえいいえ
基本チェック3/33/35/55/52/35/5
ライセンスMITAGPL-3.0Apache-2.0MITNOASSERTIONMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

MySQL MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with MySQL databases through natural language queries.

Features

  • Execute read-only SQL queries through Claude Desktop
  • Dynamic connection configuration — connect to any MySQL database at runtime via connection string
  • Built-in security with query validation (SELECT, WITH, SHOW, DESCRIBE and EXPLAIN only, one statement, no comments) plus a server-side read-only transaction
  • Easy integration with Claude Desktop
  • JSON formatted query results
  • Environment-based configuration for database credentials

Quick Start

For Claude Code Users (Recommended - Easiest Method)
claude mcp add mysql -s user -- npx -y @hovecapital/read-only-mysql-mcp-server@latest

Then set your database environment variables:

export DB_HOST=localhost

export DB_PORT=3306 export DB_DATABASE=your_database_name export DB_USERNAME=your_username export DB_PASSWORD=your_password

Done! Restart Claude Code and ask: "What tables are in my database?"

For Claude Desktop Users (Manual Configuration)

1. Open your config file:

# macOS

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

notepad %APPDATA%\Claude\claude_desktop_config.json

2. Add this configuration:

{

"mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

3. Save, restart Claude Desktop, and test!

Prerequisites

  • Node.js (v16 or higher) - If using mise, update the command path accordingly
  • MySQL database server
  • Claude Desktop application

Installation

Option 1: Install from MCP Registry (Recommended)

This server is published in the Model Context Protocol Registry as capital.hove/read-only-local-mysql-mcp-server.

Method A: Claude Code CLI (Easiest!)
claude mcp add mysql -s user -- npx -y @hovecapital/read-only-mysql-mcp-server@latest

Then configure your database credentials using environment variables. Restart Claude Code and you're done!

Benefits:

  • One command installation
  • No manual JSON editing
  • Automatic configuration
Method B: Manual JSON Configuration

For Claude Desktop:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

"mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

For Claude Code:

Edit ~/.config/claude-code/settings.json (macOS/Linux) or %APPDATA%\claude-code\settings.json (Windows):

{

"mcp": { "servers": { "mysql": { "command": "npx", "args": ["-y", "@hovecapital/read-only-mysql-mcp-server@latest"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } } }

Option 2: Install from npm
npm install -g @hovecapital/read-only-mysql-mcp-server
Option 3: Installation with Claude Code

If you're using Claude Code, you can easily install this MCP server:

# Clone the repository

git clone https://github.com/hovecapital/read-only-local-mysql-mcp-server.git cd read-only-local-mysql-mcp-server

Install dependencies and build

npm install npm run build

Then configure Claude Code by adding to your MCP settings.

Option 4: Manual Installation
1. Clone or Download

Save the repository to a directory on your system:

mkdir ~/mcp-servers/mysql

cd ~/mcp-servers/mysql git clone https://github.com/hovecapital/read-only-local-mysql-mcp-server.git .

2. Install Dependencies
npm install

npm run build

Configuration

Note: If you installed via Option 1 (MCP Registry with npx), you've already configured everything! This section is for users who chose Options 2, 3, or 4 (npm or manual installation).

Claude Code Configuration

If you're using Claude Code with a manual installation, add the MySQL server to your MCP settings:

  1. Open your Claude Code settings (typically in ~/.config/claude-code/settings.json on macOS/Linux or %APPDATA%\claude-code\settings.json on Windows)
  1. Add the MySQL MCP server configuration:
{

"mcp": { "servers": { "mysql": { "command": "node", "args": ["/absolute/path/to/read-only-local-mysql-mcp-server/dist/index.js"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } } }

  1. Restart Claude Code for the changes to take effect.
Claude Desktop Configuration

If you're using Claude Desktop with a manual installation, open your Claude Desktop configuration file:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Add the MySQL server configuration:

{

"mcpServers": { "mysql": { "command": "node", "args": ["/absolute/path/to/read-only-local-mysql-mcp-server/dist/index.js"], "env": { "DB_HOST": "localhost", "DB_PORT": "3306", "DB_DATABASE": "your_database_name", "DB_USERNAME": "your_username", "DB_PASSWORD": "your_password" } } } }

Using mise for Node.js

If you're using mise for Node.js version management, make sure to use the full path to the Node.js executable in your configuration.

Environment Variables
VariableDescriptionDefault
DB_HOSTMySQL server hostnamemysql
DB_PORTMySQL server port3306
DB_DATABASEDatabase namedatabase
DB_USERNAMEMySQL usernameroot
DB_PASSWORDMySQL password(empty)
DB_ALLOWED_HOSTSComma-separated extra hosts a connection string may point at. DB_HOST and loopback are always allowed.(empty)

Usage

  1. Restart Claude Desktop after updating the configuration
  2. Start chatting with Claude about your database
Example Queries
"Show me all tables in my database"

"What's the structure of the users table?" "Get the first 10 records from the products table" "How many orders were placed last month?" "Show me users with email addresses ending in @gmail.com"

Claude will automatically convert your natural language requests into appropriate SQL queries and execute them against your database.

Tools

connect

Connect to a MySQL database using a connection string. The connection persists for subsequent queries until changed or disconnected.

Parameters:

ParameterRequiredDescription
connectionStringYesMySQL connection string (e.g., mysql://user:password@host:port/database)
disconnect

Disconnect from the current runtime database and revert to the default environment-configured connection. Takes no parameters.

query

Run a read-only SQL query against the currently connected database.

Parameters:

ParameterRequiredDescription
sqlYesSQL query to execute (read-only)
connectionStringNoMySQL connection string to override the current connection for this query only

Dynamic Connection

The server supports switching databases at runtime without restarting. Connection priority:

  1. Per-query `connectionString` — overrides everything for a single query
  2. Runtime connection (from connect tool) — persists until disconnect is called
  3. Environment variables — the default fallback

Connection string format:

mysql://username:password@hostname:port/database_name

The hostname must be DB_HOST, a loopback address, or listed in DB_ALLOWED_HOSTS. Any other host is rejected before a connection is attempted, so the tools cannot be used to probe the network. Connection failures return a generic message and the real error is written to stderr.

Example workflow:

1. connect → mysql://analyst:pass@prod-db:3306/analytics
  1. query → SELECT COUNT(*) FROM events
  2. query → SELECT * FROM users LIMIT 5 (uses the same analytics connection)
  3. query → SELECT * FROM orders LIMIT 5, connectionString: mysql://analyst:pass@prod-db:3306/sales (one-off override — does not change the stored connection)
  4. disconnect → reverts to env var defaults

Security Features

Read-Only Operations

Queries are checked in two layers:

  1. Query validation — the statement must start with SELECT, WITH, SHOW, DESCRIBE or EXPLAIN, contain a single statement, contain no comments, and must not contain state-changing keywords anywhere (for example UPDATE, DELETE, INTO OUTFILE, INTO DUMPFILE, LOAD_FILE, FOR UPDATE, EXPLAIN ANALYZE). String literals and backtick identifiers are ignored by this check.
  2. Server-side read-only transaction — every query runs after SET SESSION TRANSACTION READ ONLY, so MySQL itself rejects writes, including writes made inside stored functions.

Use a MySQL user with only SELECT privileges as well (see below). The validation blocks the known bypasses, but the database privilege is the final guarantee.

Recommended Database Setup

For enhanced security, create a dedicated read-only user for the MCP server:

-- Create a read-only user

CREATE USER 'claude_readonly'@'localhost' IDENTIFIED BY 'secure_password';

-- Grant only SELECT permissions on your specific database GRANT SELECT ON your_database_name.* TO 'claude_readonly'@'localhost';

-- Apply the changes FLUSH PRIVILEGES;

Troubleshooting

Connection Issues
  1. Verify MySQL is running: Check if your MySQL server is active
  2. Check credentials: Ensure username/password are correct
  3. Network connectivity: Confirm Claude Desktop can reach your MySQL server
Configuration Issues
  1. Restart required: Always restart Claude Desktop after configuration changes
  2. Path accuracy: Ensure the absolute path to dist/index.js is correct
  3. JSON syntax: Validate your claude_desktop_config.json format
Debug Mode

To see server logs, you can run the server manually:

node dist/index.js

File Structure

~/mcp-servers/mysql/

├── src/ │ └── index.ts ├── dist/ │ ├── index.js │ └── index.d.ts ├── package.json ├── tsconfig.json └── node_modules/

Dependencies

  • @modelcontextprotocol/sdk: MCP protocol implementation
  • mysql2: Modern MySQL client for Node.js with Promise support

Contributing

Feel free to submit issues and enhancement requests!

License

This project is open source and available under the MIT License.

Support

If you encounter issues:

  1. Check the troubleshooting section above
  2. Verify your MySQL connection independently

3.

冒頭だけを表示しています。続きはリポジトリで読めます