MCP Server Sql Analyzer

🚀 mcp-server-sql-analyzer

このサーバーは、SQLGlotを使用して、SQLの分析、linting、方言変換機能を提供するModel Context Protocol (MCP)サーバーです。SQLAnalyzer MCPサーバーは、SQLクエリの分析と処理に役立つ強力なツールを提供します。

🚀 クイックスタート

SQLAnalyzer MCPサーバーは、SQLクエリの分析と処理に役立つ強力なツールを提供します。以下のことを実現するのに役立ちます。

• SQL構文の検証とコードチェック
• 異なるデータベース方言間でのクエリの変換（例：MySQLからPostgreSQLへ）
• テーブル参照と依存関係の抽出と分析
• 列の使用状況と関係の識別
• サポートされるSQL方言の検出

Claudeによるこのサーバーの利用方法

AIアシスタントとして、このサーバーは私がSQLクエリを処理する能力を強化します。

1. 構文検証：ユーザーに提案する前に、SQL構文の有効性を検証し、提供するクエリが構文的に正しく、ターゲットのデータベース方言の要件を満たしていることを確認できます。
2. 方言変換：ユーザーがクエリを異なるデータベースシステム間で移行する必要がある場合、クエリロジックの完全性を維持しながら、正確に構文を変換できます。
3. コード分析：テーブルと列の参照分析を通じて、複雑なクエリ構造をよりよく理解し、その仕組みを説明しやすくし、最適化提案を行いやすくなります。
4. 互換性チェック：各データベース方言とその特定の機能を理解することで、ユーザーにベストプラクティスを提案し、方言の違いによる問題を回避するのに役立ちます。

小ヒント

Claude Desktopの設定で個人設定を更新し、生成されたSQLを最初にlint_sqlツールで検証するように要求してください。

✨ 主な機能

ツール

1. lint_sql

   • SQLクエリの構文を検証し、エラー情報を返します。
   • 入力:
     • sql (文字列)：分析するSQLクエリ
     • dialect (オプションの文字列)：SQL方言（例：'mysql'、'postgresql'）
   • 戻り値:
     • is_valid (ブール値)：有効かどうか
     • message (文字列)：エラーメッセージまたは「構文エラーなし」
     • position (オプションのオブジェクト)：エラーの行と列

2. transpile_sql

   • 異なるSQL方言間でクエリを変換します。
   • 入力:
     • sql (文字列)：変換するSQL文
     • read_dialect (文字列)：ソースのSQL方言
     • write_dialect (文字列)：ターゲットのSQL方言
   • 戻り値:
     • is_valid (ブール値)：変換が成功したかどうか
     • message (文字列)：エラーメッセージまたは成功の確認
     • sql (文字列)：成功した場合は変換後のSQL

3. get_all_table_references

   • SQL内のテーブルとCTEの参照を抽出します。
   • 入力:
     • sql (文字列)：分析するSQL文
     • dialect (オプションの文字列)：SQL方言
   • 戻り値:
     • is_valid (ブール値)：分析が成功したかどうか
     • すべてのテーブル参照を表す情報

4. get_all_column_references

   • SQL内で参照されるすべての列の情報を抽出します。
   • 入力:
     • sql (文字列)：分析するSQL文
     • dialect (オプションの文字列)：SQL方言
   • 戻り値:
     • is_valid (ブール値)：分析が成功したかどうか
     • すべての列参照を表す情報

リソース

• dialects://all：サポートされるすべてのSQL方言のリストを返します。これは、適切な方言を選択して変換するのに役立ちます。

📦 インストール

このプロジェクトでは、uvxまたはuvを使用してMCPサーバーを実行できます。claude_desktop_config.jsonファイルに関連する設定を追加することで、Claude Desktopとの統合を実現し、強化されたSQL処理能力を得ることができます。

使用例

uvxを使用して実行する場合

uvx run mcp-server-sql-analyzer --config your_config.json

uvを使用して実行する場合

uv run mcp-server-sql-analyzer --env-file .env

💻 使用例

基本的な使用法

サーバーの実行

git clone https://github.com/yourusername/mcp-server-sql-analyzer.git
cd mcp-server-sql-analyzer
uv run start

テスト

このプロジェクトでは、pytestを使用した単体テストが統合されており、機能の安定性と信頼性を確保しています。

uv run pytest .

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されており、自由に使用、変更、配布することができますが、派生作品には元の作者を引用する必要があります。