MIT License
MySQL ナビゲーター MCP
MCP (モデル制御プロトコル) を使用してデータベースのクエリと管理を簡単にする強力な MySQL/MariaDB データベース ナビゲーション ツールです。
特徴
MySQL/MariaDB データベースに接続する
異なるデータベース間を動的に切り替える
型安全性を考慮したSQLクエリを実行する
データベーススキーマ情報を取得する
クエリパラメータのPydanticモデル検証
安全な資格情報管理
包括的なログシステム
接続プールと再試行メカニズム
安全な接続のためのSSL/TLSサポート
ログファイルの場所（クロスプラットフォーム）
デフォルトでは、すべてのログは次の場所に書き込まれます。
Windows:
C:\Users\<YourUsername>\.mcp\mcp-db.logmacOS/Linux:
/home/<yourusername>/.mcp/mcp-db.logユーザー名>/.mcp/mcp-db.log または/Users/<yourusername>/.mcp/mcp-db.logmcp-db.log
ホームディレクトリに.mcpフォルダが存在しない場合は、アプリケーションが自動的に作成します。問題が発生した場合は、手動でフォルダを作成してください。
ウィンドウズ:
mkdir $env:USERPROFILE\.mcp
macOS/Linux:
mkdir -p ~/.mcp
インストール
PyPI から (ほとんどのユーザーに推奨):
pip install mcp-db-navigator
ソースから（開発用）：
git clone <your-repo-url>
cd mcp-db
pip install -e .
データベースの資格情報を使用して
.envファイルを作成します。
DB_HOST=your_host
DB_PORT=your_port
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password
DB_SSL_CA=/path/to/ssl/ca.pem # Optional: for SSL/TLS connections
DB_MAX_RETRIES=3 # Optional: number of connection retries
DB_RETRY_DELAY=1.0 # Optional: delay between retries in seconds
使用例
1. コマンドライン
ターミナルから直接 MCP サーバーを実行します。
mcp-db --config /path/to/your/project/.env
2. カーソル内
この MCP サーバーをCursorで使用するには:
カーソル設定を開き、新しい MCP サーバーを追加します。
次の構成を使用します (例)。
{
"mcpServers": {
"mysql-navigator": {
"command": "mcp-db",
"args": [
"--config",
"/absolute/path/to/your/.env"
]
}
}
}
.envファイルへのパスが絶対パスであることを確認してください。
3. クロードデスクトップ
Claude Desktop が MCP サーバーをサポートしている場合:
新しい MCP サーバーを追加し、上記のように
--config引数を使用してmcp-dbコマンドにポイントします。カスタム MCP サーバーの追加の詳細については、Claude Desktop のドキュメントを参照してください。
クエリパラメータ
クエリ辞書は次のパラメータをサポートしています。
table_name(必須): クエリするテーブルの名前select_fields(オプション): 選択するフィールドのリスト (デフォルトは ["*"])where_conditions(オプション): WHERE句のフィールドと値のペアの辞書order_by(オプション): 並べ替えの基準となるフィールドのリストorder_direction(オプション): 並べ替えの方向「ASC」または「DESC」(デフォルト:「ASC」)limit(オプション): 返されるレコードの数offset（オプション）：スキップするレコード数group_by(オプション): グループ化するフィールドのリストhaving(オプション): HAVING句のフィールドと値のペアの辞書join_table(オプション): 結合するテーブルの名前join_type(オプション): JOIN操作のタイプ (デフォルト: "INNER")join_conditions（オプション）: 結合条件の辞書
セキュリティ機能
データベースの資格情報は設定ファイルを通じて管理されます
パスワードはPydanticモデルではSecretStrとして保存されます
すべてのクエリパラメータの入力検証
パラメータ化されたクエリによるSQLインジェクション防止
暗号化された接続のためのSSL/TLSサポート
接続文字列のサニタイズ
クエリのレート制限
クエリパラメータのサニタイズ
生産機能
エラー処理
データベース操作の包括的なエラー処理
接続タイムアウト処理
失敗した接続に対する自動再試行メカニズム
すべてのパラメータの入力検証
パフォーマンス
最適なリソース使用のための接続プール
クエリ実行時間のログ記録
接続プールの統計
パフォーマンスメトリックの収集
監視
異なるログレベルによる構造化ログ
クエリ実行の追跡
接続状態の監視
エラー率の追跡
貢献
リポジトリをフォークする
機能ブランチを作成します（
git checkout -b feature/amazing-feature）変更をコミットします (
git commit -m 'Add some amazing feature')ブランチにプッシュする (
git push origin feature/amazing-feature)プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
MySQL ナビゲーター MCP
Related MCP Servers
- -securityAlicense-qualityMarineTraffic MCP ServerLast updated -6MIT License
- MIT License