@mikoto_zero/minigame-open-mcp 1.18.0 → 1.19.0
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 +36 -5
- package/dist/proxy.js +1 -1
- package/dist/server.js +362 -231
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# TapTap Open API MCP 服务器
|
|
2
2
|
|
|
3
|
-
> 基于 Model Context Protocol (MCP) 的 **TapTap 小游戏和 H5
|
|
3
|
+
> 基于 Model Context Protocol (MCP) 的 **TapTap 小游戏和 H5 游戏**服务器,提供排行榜、分享、多人联机、云存档,以及当前游戏 DC 数据查询、统计概览与评价操作能力,并支持 **OAuth 2.0 零配置认证**。
|
|
4
4
|
|
|
5
|
-
🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯
|
|
5
|
+
🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **丰富 Tools & Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
|
|
6
6
|
|
|
7
7
|
## ✨ 核心特性
|
|
8
8
|
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
- **📖 完整 API 文档** - 6 个排行榜 API + 详细代码示例
|
|
11
11
|
- **⚙️ 服务端管理** - 创建/管理排行榜,自动处理 ID
|
|
12
12
|
- **🎮 H5 游戏支持** - 上传、发布、状态查询
|
|
13
|
+
- **🧭 当前游戏 DC 能力** - 商店/评价/社区统计概览、商店快照、论坛内容、评价列表、评价点赞、官方回复
|
|
13
14
|
- **🚀 三种传输模式** - stdio(本地)、SSE(远程/实时)、HTTP(兼容)
|
|
14
15
|
- **🔌 多客户端并发** - 独立会话管理,无限并发
|
|
15
16
|
- **📦 单文件 Bundle** - 零依赖,包体积减少 96%(567 KB)
|
|
@@ -17,6 +18,24 @@
|
|
|
17
18
|
|
|
18
19
|
**NPM**: [@mikoto_zero/minigame-open-mcp](https://www.npmjs.com/package/@mikoto_zero/minigame-open-mcp)
|
|
19
20
|
|
|
21
|
+
## 🧩 Codex Skills(运营简报)
|
|
22
|
+
|
|
23
|
+
本仓库内置一个面向运营/工作室的 Codex Skill:`taptap-dc-ops-brief`,用于把“当前游戏 DC 数据”整理成 30 秒可读的结论简报,并在你确认后执行评价点赞/官方回复等动作。
|
|
24
|
+
|
|
25
|
+
### 安装到 Codex
|
|
26
|
+
|
|
27
|
+
在已安装 Codex 的机器上运行:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
|
|
31
|
+
--repo taptap/taptap_minigame_open_mcp \
|
|
32
|
+
--path skills/taptap-dc-ops-brief
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
安装完成后重启 Codex,即可在对话中使用:
|
|
36
|
+
|
|
37
|
+
> 使用 `$taptap-dc-ops-brief` 生成当前游戏的 7 日运营简报,并给出是否建议点赞/回复评价(先出草稿,等我确认再发)。
|
|
38
|
+
|
|
20
39
|
## 🚀 快速开始
|
|
21
40
|
|
|
22
41
|
> 🐣 **完全不懂技术?** [快速开始(零基础版)](docs/QUICK_START.md) - 3 分钟搞定 Cursor 配置,复制粘贴就能用。
|
|
@@ -101,7 +120,7 @@ curl http://localhost:5002/health # RND
|
|
|
101
120
|
|
|
102
121
|
## 📖 功能列表
|
|
103
122
|
|
|
104
|
-
###
|
|
123
|
+
### 核心 Tools(含当前游戏 DC 能力)
|
|
105
124
|
|
|
106
125
|
#### 流程指引 (1)
|
|
107
126
|
|
|
@@ -120,10 +139,21 @@ curl http://localhost:5002/health # RND
|
|
|
120
139
|
|
|
121
140
|
#### 应用管理 (3)
|
|
122
141
|
|
|
123
|
-
- `list_developers_and_apps` -
|
|
124
|
-
- `select_app` -
|
|
142
|
+
- `list_developers_and_apps` - 列出所有开发者和应用(含关卡与非关卡)
|
|
143
|
+
- `select_app` - 选择当前应用(支持关卡与非关卡)
|
|
125
144
|
- `create_developer` - 创建新开发者
|
|
126
145
|
|
|
146
|
+
#### 当前游戏 DC 能力 (8)
|
|
147
|
+
|
|
148
|
+
- `get_current_app_store_overview` - 获取当前游戏商店统计概览(曝光、下载、预约、下载请求趋势)
|
|
149
|
+
- `get_current_app_review_overview` - 获取当前游戏评价统计概览(评分、好中差评、评分趋势)
|
|
150
|
+
- `get_current_app_community_overview` - 获取当前游戏社区统计概览(帖子、关注、浏览、趋势)
|
|
151
|
+
- `get_current_app_store_snapshot` - 获取当前游戏商店结果型快照
|
|
152
|
+
- `get_current_app_forum_contents` - 获取当前游戏论坛内容
|
|
153
|
+
- `get_current_app_reviews` - 获取当前游戏评价列表
|
|
154
|
+
- `like_current_app_review` - 给当前游戏指定评价点赞
|
|
155
|
+
- `reply_current_app_review` - 以官方身份回复当前游戏评价
|
|
156
|
+
|
|
127
157
|
#### 排行榜管理 (5)
|
|
128
158
|
|
|
129
159
|
- `create_leaderboard` - 创建排行榜
|
|
@@ -231,6 +261,7 @@ npm test
|
|
|
231
261
|
**其他**:
|
|
232
262
|
|
|
233
263
|
- `TAPTAP_MCP_ENV` - 环境:`production`(默认)或 `rnd`
|
|
264
|
+
- `TAPTAP_MCP_DC_CURRENT_APP_BASE_URL` - 当前游戏 DC 接口 host 覆盖(可选,路径仍为 `/mcp/v1/current-app/...`)
|
|
234
265
|
- `TAPTAP_MCP_TRANSPORT` - 传输模式:`stdio`(默认)、`sse`、`http`
|
|
235
266
|
- `TAPTAP_MCP_PORT` - 端口(默认 3000)
|
|
236
267
|
- `TAPTAP_MCP_VERBOSE` - 详细日志:`true` 或 `false`
|
package/dist/proxy.js
CHANGED
|
@@ -29137,7 +29137,7 @@ var LogWriter = class {
|
|
|
29137
29137
|
};
|
|
29138
29138
|
|
|
29139
29139
|
// src/mcp-proxy/proxy.ts
|
|
29140
|
-
var VERSION = true ? "1.
|
|
29140
|
+
var VERSION = true ? "1.19.0" : "dev";
|
|
29141
29141
|
var TapTapMCPProxy = class {
|
|
29142
29142
|
constructor(config2) {
|
|
29143
29143
|
this.connected = false;
|