@mikoto_zero/minigame-open-mcp 1.6.0 → 1.6.1

package/README.md

@@ -2,7 +2,7 @@
 
 > 基于 Model Context Protocol (MCP) 的 **TapTap 小游戏和 H5 游戏**服务器 - 提供排行榜文档和管理 API，支持 **OAuth 2.0 零配置认证**。
 
-🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **19 Tools + 7 Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
+🔐 **零配置 OAuth** | 📚 **完整文档** | 🎯 **19 Tools + 11 Resources** | 🌍 **小游戏 & H5** | 📦 **单文件 Bundle**
 
 ## ✨ 核心特性
 
@@ -13,6 +13,7 @@
 - **🚀 三种传输模式** - stdio（本地）、SSE（远程/实时）、HTTP（兼容）
 - **🔌 多客户端并发** - 独立会话管理，无限并发
 - **📦 单文件 Bundle** - 零依赖，包体积减少 96%（567 KB）
+- **🤖 智能引导** - AI Agent 自动验证前置条件，主动询问用户选择
 
 **NPM**: [@mikoto_zero/minigame-open-mcp](https://www.npmjs.com/package/@mikoto_zero/minigame-open-mcp)
 
@@ -128,7 +129,7 @@ curl http://localhost:5003/health
 #### 振动 API 文档 (1)
 - `get_vibrate_integration_guide` - 振动 API 完整文档和接入指引
 
-### 7 个 Resources
+### 11 个 Resources
 
 完整的排行榜 API 文档：
 - `docs://leaderboard/overview` - 完整概览
@@ -139,6 +140,12 @@ curl http://localhost:5003/health
 - `docs://leaderboard/api/load-player-score` - 玩家排名
 - `docs://leaderboard/api/load-centered-scores` - 周围玩家
 
+完整的振动 API 文档：
+- `docs://vibrate/overview` - 完整概览
+- `docs://vibrate/api/vibrate-short` - 短振动 API
+- `docs://vibrate/api/vibrate-long` - 长振动 API
+- `docs://vibrate/patterns` - 使用模式和最佳实践
+
 ## 🎯 使用示例
 
 ### 接入排行榜
@@ -222,6 +229,68 @@ npm test
 # 自动生成模块结构到 src/features/yourFeature/
 ```
 
+## 🤖 AI Agent 智能引导
+
+本服务器经过精心设计，通过工具描述引导 AI Agent 提供更智能的用户体验：
+
+### 自动前置条件检查
+
+AI Agent 会在执行排行榜操作前，自动检查是否已选择应用：
+
+```
+用户: "创建一个排行榜"
+
+AI: 让我先检查当前是否已选择应用...
+    [调用 get_current_app_info]
+    
+    发现尚未选择应用，我来帮您列出可用的应用：
+    [调用 list_developers_and_apps]
+    
+    请问您想为哪个应用创建排行榜？
+    1. 游戏 A (Developer: 开发者A, App ID: 12345)
+    2. 游戏 B (Developer: 开发者B, App ID: 67890)
+```
+
+### 主动询问用户选择
+
+当有多个选项时，AI Agent 会主动展示列表并询问用户：
+
+```
+用户: "查看排行榜"
+
+AI: 您有以下几个排行榜：
+    1. 每日高分榜 (ID: lb_001)
+    2. 周排行榜 (ID: lb_002)
+    3. 全服总榜 (ID: lb_003)
+    
+    请问您想查看哪一个？
+```
+
+### 工作流程自动优化
+
+AI Agent 会自动引导用户完成必要的步骤，避免操作失败：
+
+```mermaid
+graph LR
+    A[用户请求] --> B{检查应用选择}
+    B -->|未选择| C[列出应用]
+    C --> D[询问用户]
+    D --> E[选择应用]
+    E --> F[执行操作]
+    B -->|已选择| F
+```
+
+**受益场景：**
+- 创建/查询排行榜
+- 发布排行榜
+- 上传 H5 游戏
+- 所有需要应用上下文的操作
+
+**技术实现：**
+通过在工具描述中使用 `**PREREQUISITE:**`、`**CRITICAL:**`、`**IMPORTANT:**` 等关键词，以及明确的步骤指导，让 AI Agent 理解何时需要检查前置条件、何时应该询问用户。
+
+详见：[CLAUDE.md - AI Agent 工具使用指导](CLAUDE.md#ai-agent-工具使用指导)
+
 ## 📚 文档
 
 ### 用户文档

package/dist/proxy.js

@@ -13389,7 +13389,7 @@ var StreamableHTTPClientTransport = class {
 };
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.6.0" : "dev";
+var VERSION = true ? "1.6.1" : "dev";
 var TapTapMCPProxy = class {
   constructor(config) {
     this.connected = false;