Sqltocode

SqlToCode MCP Server

プロジェクト概要

SqlToCode は、Spring Boot 3.4 と Spring AI MCP Server Starter を基盤に構築されたサンプルサービスで、SQL フィールド定義 → Java エンティティコードへの自動変換機能を提供します。プロジェクトでは @Tool アノテーションを使って SqlToCodeService を MCP ツールとして公開しており、MCP プロトコルに対応したクライアント（Claude、Cursor、vscode 拡張機能など）から直接呼び出せます。

主な機能

• SQL→Java 自動変換：簡略化した CREATE TABLE のフィールド一覧を、@Data アノテーション付きの Java クラスに変換します。
• 組み込みの型マッピング：BIGINT / INT / VARCHAR / DECIMAL / DATETIME などの一般的な SQL 型を Java 型に自動マッピングします。
• 標準 MCP 機能：tool / resource / prompt / completion 機能が有効になっており、SSE または stdio モードで接続できます。
• ログと設定：デフォルトでは実行ログを data/log/SqlToCode.log に出力するため、問題の調査に役立ちます。

技術スタック

• Java 17
• Spring Boot 3.4.3
• Spring AI MCP Server & WebFlux Starter
• Lombok
• Maven

ディレクトリ構成

├─src/main/java/cn/maysjl/ai
│ ├─Application.java         // Spring Boot 启动类
│ ├─config/ToolConfig.java   // 注册 MCP ToolCallbackProvider
│ ├─model/                   // 请求/响应模型
│ └─service/SqlToCodeService // 核心 SQL→Code 逻辑
├─src/main/resources/application.yml
├─data/log/SqlToCode.log
└─pom.xml

動作環境

• JDK 17+
• Maven 3.9+

クイックスタート

1. クローンとビルド

   git clone <repo-url>
   cd SqlToCode
   mvn clean package -DskipTests
   

2. サービスの実行

   mvn spring-boot:run
   

   デフォルトでは http://localhost:8701 で待ち受け、MCP SSE エンドポイント /mcp/messages も公開します。

3. MCP クライアントの接続

   • SSE：クライアントの接続先として http://localhost:8701/mcp/messages を設定します。
   • stdio：application.yml で spring.main.web-application-type: none のコメントを解除し、必要に応じて調整します。

ツールの入力例

{
  "codeType": "java",
  "sqlTableName": "Product",
  "sql": [
    { "name": "id", "type": "BIGINT" },
    { "name": "name", "type": "VARCHAR(100)" },
    { "name": "price", "type": "INT" }
  ]
}

ツールの戻り値の例

{
  "codeType": "java",
  "resCode": "import lombok.Data;\n\n@Data\npublic class Product {\n\n    private Long id;\n    private String name;\n    private Integer price;\n}"
}

設定

• server.port：デフォルトは 8701 です。必要に応じて変更できます。
• spring.ai.mcp.server.*：MCP サーバーの名前、バージョン、機能、SSE エンドポイントを設定します。必要に応じて instructions を調整し、クライアントにツールの用途を説明してください。
• logging.file.name：ログファイルの保存先です。デフォルトでは data/log/SqlToCode.log に出力します。

開発とデバッグ

• SqlToCodeService.sqlToJavaType を変更すると、型マッピングを拡張できます。
• MethodToolCallbackProvider を使って、さらに多くのツールを登録できます。
• リソースやプロンプトなどの MCP 機能を追加する場合は、application.yml で該当する設定を有効にし、関連コンポーネントを実装してください。

今後の予定

• 対応するプログラミング言語を増やします（Kotlin、TypeScript DTO など）。
• 完全な CREATE TABLE 文からフィールド一覧を自動解析し、手入力を減らします。
• コアとなる型マッピングのロジックを対象に、単体テストを追加します。

業務上のニーズに応じた二次開発を歓迎します。ご質問がある場合は、issue を作成するか作者にお問い合わせください。