MCP Server Sql

🚀 mcp-server-Sql

このアプリケーションはSpring Bootに基づくSQLサービスで、SQLクエリを実行し、結果をファイルに書き込むことができます。Spring AI MCP（モデル、チャット、プロンプト）フレームワークの一部として、SQLクエリと更新操作の機能を提供します。

🚀 クイックスタート

データベースの設定

application.ymlファイルにデータベース接続情報を設定します。

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password

プロジェクトのビルド

mvn clean package

アプリケーションの実行

java -jar target/mcp-server-Sql-1.0-SNAPSHOT.jar

✨ 主な機能

• SQLクエリを実行し、結果をCSVファイルに書き込む
• SQL更新操作（INSERT、UPDATE、DELETE）を実行し、影響を受けた行数を返す
• カスタムデータベース接続設定をサポートする
• Spring AI MCPフレームワークを統合し、AIツールとして使用可能

📦 インストール

データベースの設定

application.ymlファイルにデータベース接続情報を設定します。

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password

プロジェクトのビルド

mvn clean package

アプリケーションの実行

java -jar target/mcp-server-Sql-1.0-SNAPSHOT.jar

💻 使用例

基本的な使用法

SQLクエリの実行

{
  "sql": "SELECT * FROM users",
  "outputPath": "./output/users.csv"
}

SQL更新操作の実行

{
  "sql": "UPDATE users SET name='John' WHERE id=1",
  "outputPath": "./output/update_result.txt"
}

🔧 技術詳細

• Java 17
• Spring Boot 3.4.3
• Spring AI 1.0.0 - M6
• MySQL 8.0
• HikariCP 接続プール
• Lombok

📚 ドキュメント

注意事項

⚠️ 重要提示

• 出力ディレクトリが存在するか、作成する権限があることを確認してください。
• SQLクエリ結果はCSV形式で保存されます。
• 更新操作の結果には、影響を受けた行数と実行時間が含まれます。