@mikoto_zero/minigame-open-mcp 1.9.2 → 1.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -50,6 +50,7 @@ npx @mikoto_zero/minigame-open-mcp
50
50
  ```
51
51
 
52
52
  **重要说明**:
53
+
53
54
  - **零配置 OAuth**:首次使用会提示扫码授权,token 自动保存!
54
55
  - **路径处理**:设置 `WORKSPACE_ROOT` 环境变量可以正确解析相对路径(推荐)
55
56
  - 如果不设置,相对路径会基于用户 HOME 目录(可能不符合预期)
@@ -83,37 +84,44 @@ npx @mikoto_zero/minigame-open-mcp
83
84
  ### Docker 部署
84
85
 
85
86
  ```bash
86
- # 快速启动
87
+ # 快速启动(同时运行 Production 和 RND 环境)
88
+ cd docker/npm
87
89
  docker-compose up -d
88
90
 
89
91
  # 健康检查
90
- curl http://localhost:5003/health
92
+ curl http://localhost:5003/health # Production
93
+ curl http://localhost:5002/health # RND
91
94
  ```
92
95
 
93
- 详见: [Docker 部署文档](docs/DEPLOYMENT.md#2-docker-部署)
96
+ 详见: [Docker 部署文档](docker/README.md)
94
97
 
95
98
  ## 📖 功能列表
96
99
 
97
100
  ### 19 个 Tools
98
101
 
99
102
  #### 流程指引 (1)
103
+
100
104
  - `get_leaderboard_integration_guide` - 排行榜完整接入工作流指引
101
105
 
102
106
  #### 信息查询 (2)
107
+
103
108
  - `get_current_app_info` - 获取当前应用信息
104
109
  - `check_environment` - 检查环境配置
105
110
 
106
111
  #### 认证 (3)
112
+
107
113
  - `start_oauth_authorization` - 开始 OAuth 授权(获取二维码)
108
114
  - `complete_oauth_authorization` - 完成 OAuth 授权
109
115
  - `clear_auth_data` - 清除认证数据和缓存
110
116
 
111
117
  #### 应用管理 (3)
118
+
112
119
  - `list_developers_and_apps` - 列出所有应用
113
120
  - `select_app` - 选择当前应用
114
121
  - `create_developer` - 创建新开发者
115
122
 
116
123
  #### 排行榜管理 (5)
124
+
117
125
  - `create_leaderboard` - 创建排行榜
118
126
  - `list_leaderboards` - 列出排行榜
119
127
  - `publish_leaderboard` - 发布排行榜
@@ -121,17 +129,20 @@ curl http://localhost:5003/health
121
129
  - `get_app_status` - 获取应用审核状态
122
130
 
123
131
  #### H5 游戏管理 (4)
132
+
124
133
  - `h5_game_info_gatherer` - 收集 H5 游戏信息(上传前)
125
134
  - `h5_game_uploader` - 上传 H5 游戏包
126
135
  - `h5_create_app` - 创建新 H5 游戏应用
127
136
  - `h5_edit_app` - 编辑 H5 游戏信息
128
137
 
129
138
  #### 振动 API 文档 (1)
139
+
130
140
  - `get_vibrate_integration_guide` - 振动 API 完整文档和接入指引
131
141
 
132
142
  ### 11 个 Resources
133
143
 
134
144
  完整的排行榜 API 文档:
145
+
135
146
  - `docs://leaderboard/overview` - 完整概览
136
147
  - `docs://leaderboard/api/get-manager` - 初始化
137
148
  - `docs://leaderboard/api/submit-scores` - 提交分数
@@ -141,6 +152,7 @@ curl http://localhost:5003/health
141
152
  - `docs://leaderboard/api/load-centered-scores` - 周围玩家
142
153
 
143
154
  完整的振动 API 文档:
155
+
144
156
  - `docs://vibrate/overview` - 完整概览
145
157
  - `docs://vibrate/api/vibrate-short` - 短振动 API
146
158
  - `docs://vibrate/api/vibrate-long` - 长振动 API
@@ -204,14 +216,17 @@ npm test
204
216
  ### 环境变量
205
217
 
206
218
  **OAuth 认证(推荐)**:
219
+
207
220
  - 无需配置!自动保存 token 到 `~/.config/taptap-minigame/`
208
221
 
209
222
  **手动配置(可选)**:
223
+
210
224
  - `TAPTAP_MCP_MAC_TOKEN` - MAC Token(JSON 格式)
211
225
  - `TAPTAP_MCP_CLIENT_ID` - 客户端 ID(非必需,不配置会导致部分工具无法使用)
212
226
  - `TAPTAP_MCP_CLIENT_SECRET` - 签名密钥(非必需,不配置会导致部分工具无法使用)
213
227
 
214
228
  **其他**:
229
+
215
230
  - `TAPTAP_MCP_ENV` - 环境:`production`(默认)或 `rnd`
216
231
  - `TAPTAP_MCP_TRANSPORT` - 传输模式:`stdio`(默认)、`sse`、`http`
217
232
  - `TAPTAP_MCP_PORT` - 端口(默认 3000)
@@ -242,10 +257,10 @@ AI Agent 会在执行排行榜操作前,自动检查是否已选择应用:
242
257
 
243
258
  AI: 让我先检查当前是否已选择应用...
244
259
  [调用 get_current_app_info]
245
-
260
+
246
261
  发现尚未选择应用,我来帮您列出可用的应用:
247
262
  [调用 list_developers_and_apps]
248
-
263
+
249
264
  请问您想为哪个应用创建排行榜?
250
265
  1. 游戏 A (Developer: 开发者A, App ID: 12345)
251
266
  2. 游戏 B (Developer: 开发者B, App ID: 67890)
@@ -262,7 +277,7 @@ AI: 您有以下几个排行榜:
262
277
  1. 每日高分榜 (ID: lb_001)
263
278
  2. 周排行榜 (ID: lb_002)
264
279
  3. 全服总榜 (ID: lb_003)
265
-
280
+
266
281
  请问您想查看哪一个?
267
282
  ```
268
283
 
@@ -281,6 +296,7 @@ graph LR
281
296
  ```
282
297
 
283
298
  **受益场景:**
299
+
284
300
  - 创建/查询排行榜
285
301
  - 发布排行榜
286
302
  - 上传 H5 游戏
@@ -294,10 +310,12 @@ graph LR
294
310
  ## 📚 文档
295
311
 
296
312
  ### 用户文档
313
+
297
314
  - **[CONTRIBUTING.md](CONTRIBUTING.md)** - 贡献指南
298
315
  - **[CHANGELOG.md](CHANGELOG.md)** - 版本变更历史
299
316
 
300
317
  ### 技术文档
318
+
301
319
  - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - 架构文档
302
320
  - **[docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)** - 部署指南(本地、Docker、开发者测试)
303
321
  - **[docs/PROXY.md](docs/PROXY.md)** - MCP Proxy 开发指南(面向 TapCode 等平台)
@@ -322,6 +340,7 @@ gh pr create && gh pr merge
322
340
  ```
323
341
 
324
342
  **发布流程**:
343
+
325
344
  1. PR 合并 → 触发 Actions
326
345
  2. 分析 commits 确定版本号
327
346
  3. 发布到 npm
@@ -333,6 +352,7 @@ gh pr create && gh pr merge
333
352
  ## 🤝 贡献
334
353
 
335
354
  欢迎贡献!请遵循:
355
+
336
356
  1. Fork 仓库并创建 feature 分支
337
357
  2. 使用 Conventional Commits 规范
338
358
  3. 创建 PR,等待 CI 检查
package/dist/proxy.js CHANGED
@@ -13389,7 +13389,7 @@ var StreamableHTTPClientTransport = class {
13389
13389
  };
13390
13390
 
13391
13391
  // src/mcp-proxy/proxy.ts
13392
- var VERSION = true ? "1.9.2" : "dev";
13392
+ var VERSION = true ? "1.10.1" : "dev";
13393
13393
  var TapTapMCPProxy = class {
13394
13394
  constructor(config) {
13395
13395
  this.connected = false;