File tree Expand file tree Collapse file tree 5 files changed +707
-0
lines changed Expand file tree Collapse file tree 5 files changed +707
-0
lines changed Original file line number Diff line number Diff line change 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 上添加详细的使用示例
Original file line number Diff line number Diff line change 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
You can’t perform that action at this time.
0 commit comments