@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 +26 -6
- package/dist/native/taptap-signer.win32-x64-msvc.node +0 -0
- package/dist/proxy.js +1 -1
- package/dist/server.js +74 -70
- package/package.json +2 -1
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 部署文档](
|
|
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 检查
|
|
Binary file
|
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.
|
|
13392
|
+
var VERSION = true ? "1.10.1" : "dev";
|
|
13393
13393
|
var TapTapMCPProxy = class {
|
|
13394
13394
|
constructor(config) {
|
|
13395
13395
|
this.connected = false;
|