Mybatis Mapper2SQL MCP Server

🚀 MyBatis Mapper2SQL MCP Server

このサービスは、Model Context Protocol (MCP) をベースにした MyBatis Mapper XML からの SQL 抽出サービスです。MyBatis Mapper XML ファイルから SQL 文を抽出し、AI モデルと連携して、より強力な SQL 抽出と分析機能を提供します。

🚀 クイックスタート

本プロジェクトは、既存の MyBatis Mapper2SQL ツールを MCP (Model Context Protocol) サービスに変換し、AI 時代においてもその価値を発揮し、AI モデルと協力してより強力な SQL 抽出と分析機能を提供します。spring-ai をベースに、stdio（stdin/stdout）モードを提供し、標準入出力を介してプロセス間通信を行い、コマンドラインツールの統合に適しています。

✨ 主な機能

• SQL抽出：MyBatis mapper XMLファイルからSQL文を抽出します。
• パラメータモック：SQLパラメータを自動生成し、resultMapとJDBC接続に基づく型推論をサポートします。
• SQLテスト：データベースに接続してSQLを実行し、実行結果を記録します。

🔧 技術詳細

1. 確定的解析：MyBatis公式の解析エンジンを使用しているため、結果は安定して信頼性が高いです。
2. AI連携：AIの「専門ツール」として、正確なSQL解析機能を提供します。
3. サービス化：MCPプロトコルを通じて標準化されたインターフェースを提供します。
4. 拡張性：複数のデータベースタイプをサポートしています。

📦 インストール

コンパイルと実行

参考

MCPクライアントの設定

参考

💻 使用例

基本的な使用法

基本的な SQL 抽出（パラメータモックなし）の例です。

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

高度な使用法

パラメータモック付きの 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"
  }
}

📚 ドキュメント

本プロジェクトは、3つの専用ツールを提供し、さまざまなシナリオでの SQL 抽出ニーズを満たします。

1. parse_mapper

• 機能：基本的な SQL 抽出（パラメータモックなし）
• 適用シーン：SQL 構造を素早く確認する場合
• パラメータ：
  • filePath (string)：mapper XML ファイルまたはディレクトリのパス

2. parse_mapper_and_mock

• 機能：SQL 抽出 + パラメータ自動モック
• 適用シーン：テストや分析用の実行可能な SQL が必要な場合
• パラメータ：
  • filePath (string)：mapper XML ファイルまたはディレクトリのパス

3. parse_mapper_and_run_test

• 機能：SQL 抽出 + パラメータモック + テスト実行
• 適用シーン：実際のデータベースでの SQL の実行状況を検証する場合
• パラメータ：
  • filePath (string)：mapper XML ファイルまたはディレクトリのパス

参考

• spring-ai weather examples
• modelcontextprotocol quickstart java server