local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Enables secure connections to local MySQL databases, supporting all types of SQL queries (SELECT, INSERT, UPDATE, DELETE, etc.) through natural language interaction
Claude デスクトップ用の SQL MCP サーバー
Claude Desktop を介した、ローカル MySQL データベースへの自然言語インターフェース。この MCP (Machine Communication Protocol) サーバーにより、Claude はローカル MySQL データベースに対して SQL クエリを実行できるため、自然言語でデータベースを操作できるようになります。
特徴
- Claudeによる自然言語からSQLクエリへの変換
- ローカル MySQL データベースへの安全な接続
- 複数のデータベースのサポート
- データの一貫性を保つためのトランザクション管理
- パフォーマンス向上のための接続プール
- すべての種類の SQL クエリ (SELECT、INSERT、UPDATE、DELETE など) のサポート
前提条件
- Python 3.8以上
- MySQLサーバーがインストールされ、実行中
- クロードデスクトップアプリケーション
- 仮想環境(推奨)
インストール
- このリポジトリをクローンします:
Copy
- 仮想環境を作成してアクティブ化します。
Copy
- 依存関係をインストールします:
Copy
- MySQL 資格情報を使用して、プロジェクト ルートに
.env
ファイルを作成します。
Copy
run.sh
内のディレクトリ パスを更新します。
Copy
- 実行スクリプトを実行可能にします。
Copy
Claude Desktopでの設定
- Claude DesktopのMCP構成を開く
- 次の構成を追加します。
Copy
/absolute/path/to/your/mysql-mcp
プロジェクト ディレクトリへの実際の絶対パスに置き換えます。
使用法
設定が完了すると、Claude Desktop を通じて自然言語でデータベースを操作できるようになります。例:
- データベースの選択とテーブルの作成:
Copy
- データの挿入:
Copy
- データのクエリ:
Copy
重要な注意事項
- run.sh スクリプトと Claude Desktop 構成では常に絶対パスを使用します。
- MCP サーバーを使用する前に、MySQL サーバーが実行中であることを確認してください。
- .env ファイルを安全に保ち、バージョン管理にコミットしないでください。
- MCPサーバーは、デフォルトのプールサイズが5接続である接続プールを使用します。
トラブルシューティング
- 「接続拒否」エラーが発生した場合は、MySQLサーバーが動作していることを確認してください。
- 認証エラーが発生した場合は、.envファイル内の資格情報を確認してください。
- 権限エラーの場合は、MySQLユーザーが実行しようとしている操作に対して適切な権限を持っていることを確認してください。
セキュリティに関する考慮事項
- 機密性の高い認証情報を .env ファイルに保存する
- 適切な権限を持つ MySQL ユーザーを使用する (root の使用は避ける)
- 仮想環境と依存関係を最新の状態に保つ
- ローカルホスト以外のMySQLサーバーにアクセスする場合はネットワークセキュリティを考慮する
This server cannot be installed
Claude がローカル MySQL データベースで SQL クエリを実行できるようにする自然言語インターフェース。これにより、自然言語を使用したデータベース操作が可能になります。
- Features
- Prerequisites
- Installation
- Configuration in Claude Desktop
- Usage
- Important Notes
- Troubleshooting
- Security Considerations