upd 使用spring-ai实现stdio模式

Author: handsomestWei

Dockerfile

@@ -6,7 +6,7 @@
 
 本项目将原有的 [MyBatis Mapper2SQL](https://github.com/handsomestWei/mybatis-mapper2sql) 工具，转型为 MCP (Model Context Protocol) 服务，使其能够在 AI 时代继续发挥价值，并与 AI 模型协作提供更强大的 SQL 提取和分析能力。
 
-基于[modelcontextprotocol java sdk](https://github.com/modelcontextprotocol/java-sdk), 提供stdio（stdin/stdout）模式，通过标准输入输出，进行进程间通信，适用于命令行工具集成。
+基于spring-ai, 提供stdio（stdin/stdout）模式，通过标准输入输出，进行进程间通信，适用于命令行工具集成。
 
 ## 功能特性
 
@@ -25,23 +25,22 @@
 本项目提供3个专业工具，满足不同场景的SQL提取需求：
 
 #### 1. parse_mapper
-- **功能**: 基础 SQL 提取，保留占位符
+- **功能**: 基础 SQL 提取，保留占位符（不进行参数模拟）
 - **适用场景**: 快速查看 SQL 结构，无需参数 mock
 - **参数:**
-  - `file_path` (string): mapper XML文件或目录路径
+  - `filePath` (string): mapper XML文件或目录路径
 
-#### 2. parse_mapper_with_mock
+#### 2. parse_mapper_and_mock
 - **功能**: SQL 提取 + 参数自动 mock
 - **适用场景**: 需要可执行 SQL 进行测试或分析
 - **参数:**
-  - `file_path` (string): mapper XML文件或目录路径
-  - `use_jdbc_connection` (boolean, 可选): 是否使用JDBC连接进行类型推断
+  - `filePath` (string): mapper XML文件或目录路径
 
-#### 3. parse_mapper_with_test
+#### 3. parse_mapper_and_run_test
 - **功能**: SQL 提取 + 参数 mock + 执行测试
 - **适用场景**: 验证 SQL 在真实数据库中的执行情况
 - **参数:**
-  - `file_path` (string): mapper XML文件或目录路径
+  - `filePath` (string): mapper XML文件或目录路径
 
 ## 使用说明
 
@@ -52,34 +51,38 @@
 [参考](/mcp-config-example.json)
 
 ## 使用示例
+参考[本地使用Trae MCP客户端调试说明](/doc/本地使用Trae%20MCP客户端调试说明.md)
 
 ### 基本SQL提取
 ```json
 {
   "name": "parse_mapper",
   "arguments": {
-    "file_path": "/path/to/mapper.xml"
+    "filePath": "/path/to/mapper.xml"
   }
 }
 ```
 
 ### 带参数Mock的SQL提取
 ```json
 {
-  "name": "parse_mapper_with_mock",
+  "name": "parse_mapper_and_mock",
   "arguments": {
-    "file_path": "/path/to/mapper.xml",
-    "use_jdbc_connection": false
+    "filePath": "/path/to/mapper.xml"
   }
 }
 ```
 
 ### SQL测试
 ```json
 {
-  "name": "parse_mapper_with_test",
+  "name": "parse_mapper_and_run_test",
   "arguments": {
-    "file_path": "/path/to/mapper.xml"
+    "filePath": "/path/to/mapper.xml"
   }
 }
 ```
+
+## 参考
++ [spring-ai weather examples](https://github.com/spring-projects/spring-ai-examples/blob/main/model-context-protocol/weather/starter-stdio-server/README.md)
++ [modelcontextprotocol quickstart java server](https://modelcontextprotocol.io/quickstart/server#java)

README.md

@@ -0,0 +1,26 @@
+# 本地使用Trae MCP客户端调试说明
+
+本文档介绍如何在本地使用Trae MCP客户端来调试和测试MyBatis Mapper2SQL MCP服务。
+
+## 准备工作
+
+1. 确保已编译并打包项目：
+   ```bash
+   mvn clean package -DskipTests
+   ```
+
+2. 确保生成了可执行的JAR文件：`target/mapper2sql-mcp-server-1.0.0.jar`
+
+## 配置步骤
+
+### 步骤1：添加MCP服务
+
+![添加MCP服务](1-添加MCP服务.jpg)
+
+### 步骤2：创建智能体
+
+![创建智能体](2-创建智能体.jpg)
+
+### 步骤3：使用智能体对话
+
+![使用智能体对话](3-使用该智能体对话.jpg)

doc/1-添加MCP服务.jpg

@@ -13,7 +13,8 @@
                 "mapper2sql-mcp-server-1.0.0.jar"
             ],
             "env": {
-                "JAVA_HOME": "/path/to/jdk17"
+                "JAVA_HOME": "/path/to/jdk17",
+                "PATH": "/path/to/jdk17/bin;${PATH}"
             }
         }
     }

doc/2-创建智能体.jpg

@@ -3,7 +3,7 @@
     "version": "1.0.0",
     "description": "Extract SQL from MyBatis mapper XML files with parameter mocking and testing capabilities",
     "author": "handsomestWei",
-    "license": "MIT",
+    "license": "Apache License 2.0",
     "repository": {
         "type": "git",
         "url": "https://github.com/handsomestWei/mybatis-mapper2sql-mcp-server"
@@ -20,81 +20,76 @@
     "tools": [
         {
             "name": "parse_mapper",
-            "description": "Parse MyBatis mapper XML files and extract SQL statements with placeholders",
+            "description": "Parse MyBatis mapper XML files and extract SQL statements with placeholders (no parameter mocking)",
             "inputSchema": {
                 "type": "object",
                 "properties": {
-                    "file_path": {
+                    "filePath": {
                         "type": "string",
                         "description": "Path to mapper XML file or directory"
                     }
                 },
                 "required": [
-                    "file_path"
+                    "filePath"
                 ]
             }
         },
         {
-            "name": "parse_mapper_with_mock",
-            "description": "Parse MyBatis mapper XML files and extract SQL statements with parameter mocking",
+            "name": "parse_mapper_and_mock",
+            "description": "Parse MyBatis mapper XML files and extract SQL statements and mock parameters",
             "inputSchema": {
                 "type": "object",
                 "properties": {
-                    "file_path": {
+                    "filePath": {
                         "type": "string",
                         "description": "Path to mapper XML file or directory"
-                    },
-                    "use_jdbc_connection": {
-                        "type": "boolean",
-                        "description": "Whether to use JDBC connection for type inference (default: false)"
                     }
                 },
                 "required": [
-                    "file_path"
+                    "filePath"
                 ]
             }
         },
         {
-            "name": "parse_mapper_with_test",
+            "name": "parse_mapper_and_run_test",
             "description": "Parse MyBatis mapper XML files, extract SQL statements with parameter mocking, and test execution",
             "inputSchema": {
                 "type": "object",
                 "properties": {
-                    "file_path": {
+                    "filePath": {
                         "type": "string",
                         "description": "Path to mapper XML file or directory"
                     }
                 },
                 "required": [
-                    "file_path"
+                    "filePath"
                 ]
             }
         }
     ],
     "examples": [
         {
             "name": "Basic SQL Extraction",
-            "description": "Extract SQL from a MyBatis mapper XML file",
+            "description": "Extract SQL from a MyBatis mapper XML file with placeholders",
             "tool": "parse_mapper",
             "arguments": {
-                "file_path": "/path/to/UserMapper.xml"
+                "filePath": "/path/to/UserMapper.xml"
             }
         },
         {
             "name": "SQL Extraction with Parameter Mocking",
             "description": "Extract SQL with automatically mocked parameters",
-            "tool": "parse_mapper_with_mock",
+            "tool": "parse_mapper_and_mock",
             "arguments": {
-                "file_path": "/path/to/UserMapper.xml",
-                "use_jdbc_connection": true
+                "filePath": "/path/to/UserMapper.xml"
             }
         },
         {
             "name": "SQL Testing",
             "description": "Extract SQL, mock parameters, and test execution",
-            "tool": "parse_mapper_with_test",
+            "tool": "parse_mapper_and_run_test",
             "arguments": {
-                "file_path": "/path/to/UserMapper.xml"
+                "filePath": "/path/to/UserMapper.xml"
             }
         }
     ],