Skip to content

Commit f62fa2b

Browse files
committed
add 增加本地mcp client测试脚本
1 parent 0aef5f2 commit f62fa2b

File tree

5 files changed

+707
-0
lines changed

5 files changed

+707
-0
lines changed

PUBLISH_GUIDE.md

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
# 发布到 mcp.so 市场指南
2+
3+
本指南将帮助你将 MyBatis Mapper2SQL MCP Server 发布到 [mcp.so](https://mcp.so) 市场。
4+
5+
## 准备工作
6+
7+
### 1. 构建项目
8+
```bash
9+
# 在 mcp-server 目录下
10+
chmod +x build.sh
11+
./build.sh
12+
```
13+
14+
### 2. 验证构建结果
15+
确保以下文件存在:
16+
- `target/mapper2sql-mcp-server-1.0.0.jar`
17+
- `mcp-registry.json`
18+
- `README.md`
19+
20+
### 3. 测试MCP服务器
21+
```bash
22+
chmod +x test-mcp.sh
23+
./test-mcp.sh
24+
```
25+
26+
## 发布步骤
27+
28+
### 1. 创建 GitHub Release
29+
30+
1. 在 GitHub 仓库中创建新的 Release
31+
2. 版本号:`v1.0.0`
32+
3. 上传以下文件:
33+
- `mapper2sql-mcp-server-1.0.0.jar`
34+
- `mcp-registry.json`
35+
- `README.md`
36+
37+
### 2. 更新 mcp-registry.json
38+
39+
确保 `mcp-registry.json` 中的下载链接指向正确的 GitHub Release:
40+
41+
```json
42+
{
43+
"installation": {
44+
"downloadUrl": "https://github.com/handsomestWei/mybatis-mapper2sql-mcp-server/releases/download/v1.0.0/mapper2sql-mcp-server-1.0.0.jar"
45+
}
46+
}
47+
```
48+
49+
### 3. 提交到 mcp.so
50+
51+
1. 访问 [mcp.so](https://mcp.so)
52+
2. 点击 "Submit Server"
53+
3. 填写以下信息:
54+
- **Name**: mapper2sql
55+
- **Description**: Extract SQL from MyBatis mapper XML files with parameter mocking and testing capabilities
56+
- **Repository**: https://github.com/handsomestWei/mybatis-mapper2sql-mcp-server
57+
- **Registry File**: 上传 `mcp-registry.json`
58+
- **Documentation**: https://github.com/handsomestWei/mybatis-mapper2sql-mcp-server/blob/main/README.md
59+
60+
### 4. 等待审核
61+
62+
mcp.so 团队会审核你的提交,通常需要 1-3 个工作日。
63+
64+
## 发布后验证
65+
66+
### 1. 在 mcp.so 上搜索
67+
搜索 "mapper2sql" 确认服务器已成功发布。
68+
69+
### 2. 测试集成
70+
使用支持 MCP 的客户端(如 Claude Desktop)测试服务器功能。
71+
72+
### 3. 收集反馈
73+
关注用户反馈,及时更新和改进。
74+
75+
## 版本更新
76+
77+
### 1. 更新版本号
78+
- `pom.xml` 中的版本号
79+
- `mcp-registry.json` 中的版本号
80+
- GitHub Release 标签
81+
82+
### 2. 更新文档
83+
- 更新 `README.md`
84+
- 更新 `mcp-registry.json` 中的示例和描述
85+
86+
### 3. 重新发布
87+
按照上述步骤重新发布新版本。
88+
89+
## 常见问题
90+
91+
### Q: 如何确保 MCP 服务器兼容性?
92+
A: 确保使用标准的 MCP SDK 和协议,测试所有工具的功能。
93+
94+
### Q: 如何处理用户反馈?
95+
A: 在 GitHub Issues 中跟踪用户反馈,及时响应和修复问题。
96+
97+
### Q: 如何推广我的 MCP 服务器?
98+
A:
99+
- 在相关技术社区分享
100+
- 写博客文章介绍功能
101+
- 在 GitHub 上添加详细的使用示例

scripts/build.bat

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
@echo off
2+
echo 使用JDK 17编译项目...
3+
4+
REM 获取脚本所在目录的上级目录(项目根目录)
5+
set SCRIPT_DIR=%~dp0
6+
set PROJECT_ROOT=%SCRIPT_DIR%..
7+
cd /d "%PROJECT_ROOT%"
8+
9+
echo 当前工作目录: %CD%
10+
11+
REM 设置JDK 17路径(请根据实际安装路径修改)
12+
set JDK17_HOME=C:\Program Files\Java\jdk17.0.16
13+
14+
REM 检查JDK 17是否存在
15+
if not exist "%JDK17_HOME%" (
16+
echo 错误:找不到JDK 17安装路径: %JDK17_HOME%
17+
echo 请修改脚本中的JDK17_HOME变量为正确的安装路径
18+
pause
19+
exit /b 1
20+
)
21+
22+
echo 找到JDK 17: %JDK17_HOME%
23+
24+
REM 临时设置JAVA_HOME和PATH
25+
set JAVA_HOME=%JDK17_HOME%
26+
set PATH=%JDK17_HOME%\bin;%PATH%
27+
28+
echo 当前Java版本:
29+
java -version
30+
31+
echo.
32+
echo 开始编译项目...
33+
mvn clean package -DskipTests
34+
35+
echo.
36+
echo 编译完成!
37+
pause

0 commit comments

Comments
 (0)