Mybatis Mapper2SQL MCP Server

🚀 MyBatis Mapper2SQL MCP Server

本項目是一個基於Model Context Protocol (MCP)的MyBatis Mapper XML SQL提取服務，能從MyBatis mapper XML文件中提取SQL語句，還可進行參數模擬和SQL測試，與AI模型協作提供強大的SQL提取和分析能力。

🚀 快速開始

• 編譯運行：參考
• MCP客戶端配置：參考
• 使用示例：參考本地使用Trae MCP客戶端調試說明

✨ 主要特性

• SQL提取：從MyBatis mapper XML文件中提取SQL語句。
• 參數Mock：自動生成SQL參數，支持基於resultMap和JDBC連接的類型推斷。
• SQL測試：連接數據庫執行SQL並記錄執行結果。

🔧 核心優勢

1. 確定性解析：基於MyBatis官方解析引擎，結果穩定可靠。
2. AI協作：作為AI的“專家工具”，提供精確的SQL解析能力。
3. 服務化：通過MCP協議提供標準化接口。
4. 擴展性：支持多種數據庫類型。

📦 可用工具

本項目提供3個專業工具，滿足不同場景的SQL提取需求：

1. parse_mapper

• 功能：基礎SQL提取，保留佔位符（不進行參數模擬）。
• 適用場景：快速查看SQL結構，無需參數mock。
• 參數：
  • filePath (string)：mapper XML文件或目錄路徑。

2. parse_mapper_and_mock

• 功能：SQL提取 + 參數自動mock。
• 適用場景：需要可執行SQL進行測試或分析。
• 參數：
  • filePath (string)：mapper XML文件或目錄路徑。

3. parse_mapper_and_run_test

• 功能：SQL提取 + 參數mock + 執行測試。
• 適用場景：驗證SQL在真實數據庫中的執行情況。
• 參數：
  • filePath (string)：mapper XML文件或目錄路徑。

💻 使用示例

基礎用法

{
  "name": "parse_mapper",
  "arguments": {
    "filePath": "/path/to/mapper.xml"
  }
}

高級用法

帶參數Mock的SQL提取

{
  "name": "parse_mapper_and_mock",
  "arguments": {
    "filePath": "/path/to/mapper.xml"
  }
}

SQL測試

{
  "name": "parse_mapper_and_run_test",
  "arguments": {
    "filePath": "/path/to/mapper.xml"
  }
}

📚 參考

• spring-ai weather examples
• modelcontextprotocol quickstart java server