@mikoto_zero/minigame-open-mcp 1.18.0 → 1.20.0

package/README.md

@@ -1,8 +1,8 @@
 # TapTap Open API MCP 服务器
 
-> 基于 Model Context Protocol (MCP) 的 **TapTap 小游戏和 H5 游戏**服务器 - 提供排行榜文档和管理 API，支持 **OAuth 2.0 零配置认证**。
+> 基于 Model Context Protocol (MCP) 的 **TapTap 小游戏和 H5 游戏**服务器，提供排行榜、分享、多人联机、云存档，以及当前游戏 DC 数据查询、统计概览与评价操作能力，并支持 **OAuth 2.0 零配置认证**。
 
-🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **19 Tools + 11 Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
+🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **丰富 Tools & Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
 
 ## ✨ 核心特性
 
@@ -10,6 +10,8 @@
 - **📖 完整 API 文档** - 6 个排行榜 API + 详细代码示例
 - **⚙️ 服务端管理** - 创建/管理排行榜，自动处理 ID
 - **🎮 H5 游戏支持** - 上传、发布、状态查询
+- **🧭 当前游戏 DC 能力** - 商店/评价/社区统计概览、商店快照、论坛内容、评价列表、评价点赞、官方回复
+- **🦞 OpenClaw Plugin** - 提供一个原生 OpenClaw plugin 子包，内部复用 TapTap MCP 运行时并暴露 raw JSON 工具 + bundled skill
 - **🚀 三种传输模式** - stdio（本地）、SSE（远程/实时）、HTTP（兼容）
 - **🔌 多客户端并发** - 独立会话管理，无限并发
 - **📦 单文件 Bundle** - 零依赖，包体积减少 96%（567 KB）
@@ -17,6 +19,48 @@
 
 **NPM**: [@mikoto_zero/minigame-open-mcp](https://www.npmjs.com/package/@mikoto_zero/minigame-open-mcp)
 
+## 🦞 OpenClaw Plugin（实验中）
+
+仓库内提供了一个可独立发布的 OpenClaw plugin 子包：
+
+- [`packages/openclaw-dc-plugin`](packages/openclaw-dc-plugin)
+
+这个子包的设计目标是：
+
+- 让 OpenClaw 用户只安装一个 plugin
+- plugin 内部复用 `@mikoto_zero/minigame-open-mcp` 运行时
+- 对 OpenClaw 暴露 raw JSON 工具
+- 同时内置 `taptap-dc-ops-brief` skill，让模型自己做简报解读
+
+说明：
+
+- 主包里的 `*_raw` tools 默认不会暴露给普通 MCP 客户端
+- 只有设置 `TAPTAP_MCP_ENABLE_RAW_TOOLS=true` 时才会注册
+- OpenClaw plugin 会自动打开这个开关，因此插件用户不需要额外配置
+
+详见：
+
+- [OpenClaw Plugin 说明](docs/OPENCLAW_PLUGIN.md)
+- 维护者发布方式：`npm run openclaw:pack` / `npm run openclaw:publish`
+
+## 🧩 Codex Skills（运营简报）
+
+本仓库内置一个面向运营/工作室的 Codex Skill：`taptap-dc-ops-brief`，用于把“当前游戏 DC 数据”整理成 30 秒可读的结论简报，并在你确认后执行评价点赞/官方回复等动作。
+
+### 安装到 Codex
+
+在已安装 Codex 的机器上运行：
+
+```bash
+python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
+  --repo taptap/taptap_minigame_open_mcp \
+  --path skills/taptap-dc-ops-brief
+```
+
+安装完成后重启 Codex，即可在对话中使用：
+
+> 使用 `$taptap-dc-ops-brief` 生成当前游戏的 7 日运营简报，并给出是否建议点赞/回复评价（先出草稿，等我确认再发）。
+
 ## 🚀 快速开始
 
 > 🐣 **完全不懂技术？** [快速开始（零基础版）](docs/QUICK_START.md) - 3 分钟搞定 Cursor 配置，复制粘贴就能用。
@@ -101,7 +145,7 @@ curl http://localhost:5002/health  # RND
 
 ## 📖 功能列表
 
-### 20 个 Tools
+### 核心 Tools（含当前游戏 DC 能力）
 
 #### 流程指引 (1)
 
@@ -120,10 +164,21 @@ curl http://localhost:5002/health  # RND
 
 #### 应用管理 (3)
 
-- `list_developers_and_apps` - 列出所有应用
-- `select_app` - 选择当前应用
+- `list_developers_and_apps` - 列出所有开发者和应用（含关卡与非关卡）
+- `select_app` - 选择当前应用（支持关卡与非关卡）
 - `create_developer` - 创建新开发者
 
+#### 当前游戏 DC 能力 (8)
+
+- `get_current_app_store_overview` - 获取当前游戏商店统计概览（曝光、下载、预约、下载请求趋势）
+- `get_current_app_review_overview` - 获取当前游戏评价统计概览（评分、好中差评、评分趋势）
+- `get_current_app_community_overview` - 获取当前游戏社区统计概览（帖子、关注、浏览、趋势）
+- `get_current_app_store_snapshot` - 获取当前游戏商店结果型快照
+- `get_current_app_forum_contents` - 获取当前游戏论坛内容
+- `get_current_app_reviews` - 获取当前游戏评价列表
+- `like_current_app_review` - 给当前游戏指定评价点赞
+- `reply_current_app_review` - 以官方身份回复当前游戏评价
+
 #### 排行榜管理 (5)
 
 - `create_leaderboard` - 创建排行榜
@@ -231,6 +286,7 @@ npm test
 **其他**:
 
 - `TAPTAP_MCP_ENV` - 环境：`production`（默认）或 `rnd`
+- `TAPTAP_MCP_DC_CURRENT_APP_BASE_URL` - 当前游戏 DC 接口 host 覆盖（可选，路径仍为 `/mcp/v1/current-app/...`）
 - `TAPTAP_MCP_TRANSPORT` - 传输模式：`stdio`（默认）、`sse`、`http`
 - `TAPTAP_MCP_PORT` - 端口（默认 3000）
 - `TAPTAP_MCP_VERBOSE` - 详细日志：`true` 或 `false`

package/dist/proxy.js

@@ -29137,7 +29137,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.18.0" : "dev";
+var VERSION = true ? "1.20.0" : "dev";
 var TapTapMCPProxy = class {
   constructor(config2) {
     this.connected = false;