MCP Server Sql Analyzer

🚀 mcp-server-sql-analyzer

這是一個基於SQLGlot構建的Model Context Protocol (MCP)服務器，它具備強大的SQL分析、linting和方言轉換功能，能為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

✨ 主要特性

SQLAnalyzer MCP服務器提供了分析和處理SQL查詢的強大工具，可幫助實現以下功能：

• SQL語法驗證和代碼檢查
• 查詢在不同數據庫方言之間的轉換（如MySQL到PostgreSQL）
• 表引用和依賴關係的提取與分析
• 列使用情況及關係的識別
• 支持的SQL方言發現

Claude如何利用此服務器

作為AI助手，此服務器增強了Claude在處理SQL查詢方面的能力：

1. 語法驗證：在向用戶建議之前，Claude可以先驗證SQL語法的有效性，確保提供的查詢語法正確且符合目標數據庫方言的要求。
2. 方言轉換：當用戶需要將查詢在不同數據庫系統之間遷移時，Claude可以準確地進行語法轉換，同時保持查詢邏輯的完整性。
3. 代碼分析：通過表和列引用分析，Claude能夠更好地理解複雜的查詢結構，從而更輕鬆地解釋其工作原理並提出優化建議。
4. 兼容性檢查：瞭解各數據庫方言及其特定功能後，Claude可以引導用戶採用最佳實踐，並幫助避免因方言差異導致的問題。

這些工具使Claude能提供更為精準和有效的SQL相關支持，同時降低語法錯誤或方言適配問題的風險。

小技巧

在Claude Desktop設置中更新您的個人偏好，以要求生成的SQL首先通過lint_sql工具進行驗證。

📦 安裝指南

對於開發者，可通過克隆倉庫並執行適當的命令，快速啟動開發環境：

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

💻 使用示例

基礎用法

項目集成了pytest用於單元測試，確保功能的穩定性和可靠性。

uv run pytest .

📚 詳細文檔

工具

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方言列表，這對於選擇合適的方言進行轉換非常有用。

📄 許可證

本項目採用MIT許可證，允許自由使用、修改和分發，但需在衍生作品中引用原作者。