@taptap/instant-games-open-mcp 1.21.0 → 1.22.0-beta.1

package/README.md

@@ -103,6 +103,7 @@ npx @taptap/instant-games-open-mcp
 - **路径处理**：设置 `TAPTAP_MCP_WORKSPACE_ROOT` 环境变量可以正确解析相对路径（推荐）
   - 如果不设置，相对路径会基于用户 HOME 目录（可能不符合预期）
   - 建议使用绝对路径，或配置 `TAPTAP_MCP_WORKSPACE_ROOT`
+- **Windows 启动报 `Received protocol 'c:'`**：这是旧版本 Windows ESM 动态导入路径兼容问题，请升级到包含该修复的最新版本。
 
 #### OpenHands（推荐 SSE 模式）
 
@@ -151,10 +152,11 @@ curl http://localhost:5002/health  # RND
 
 - `get_leaderboard_integration_guide` - 排行榜完整接入工作流指引
 
-#### 信息查询 (2)
+#### 信息查询 (3)
 
 - `get_current_app_info` - 获取当前应用信息
 - `check_environment` - 检查环境配置
+- `get_environment_switch_guide` - 获取 production/RND 环境切换配置指引
 
 #### 认证 (3)
 
@@ -302,6 +304,13 @@ npm test
 
 详细说明请参考 [docs/LOG_SYSTEM.md](docs/LOG_SYSTEM.md)
 
+### 环境切换帮助
+
+如果需要在 AI 对话中切换测试环境，可以让 AI 调用
+`get_environment_switch_guide` 查看配置示例，再更新 MCP 客户端配置中的 `env` 字段。
+RND 环境需要显式配置 `TAPTAP_MCP_CLIENT_ID` 和 `TAPTAP_MCP_CLIENT_SECRET`，
+production 通常使用内置 native signer，无需额外配置。
+
 ### 添加新功能
 
 ```bash

package/bin/instant-games-open-mcp

@@ -9,7 +9,7 @@
 
 import { join, dirname } from 'node:path';
 import { existsSync, readdirSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 // Get current directory in ESM
 const __filename = fileURLToPath(import.meta.url);
@@ -20,6 +20,7 @@ const packageRoot = join(__dirname, '..');
 
 // Check if compiled version exists
 const distPath = join(packageRoot, 'dist', 'server.js');
+const distUrl = pathToFileURL(distPath).href;
 const nativePath = join(packageRoot, 'dist', 'native');
 
 if (!existsSync(distPath)) {
@@ -52,7 +53,7 @@ if (!existsSync(nativePath)) {
 }
 
 // Start server
-import(distPath).catch(error => {
+import(distUrl).catch(error => {
     console.error('');
     console.error('❌ Failed to start server:', error.message);
     console.error('');

package/bin/taptap-mcp-proxy

@@ -9,7 +9,7 @@
 
 import { join, dirname } from 'node:path';
 import { existsSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 // Get current directory in ESM
 const __filename = fileURLToPath(import.meta.url);
@@ -20,10 +20,11 @@ const packageRoot = join(__dirname, '..');
 
 // Check if bundled version exists
 const distPath = join(packageRoot, 'dist', 'proxy.js');
+const distUrl = pathToFileURL(distPath).href;
 
 if (existsSync(distPath)) {
     // Use dynamic import for ES Module
-    import(distPath).catch(error => {
+    import(distUrl).catch(error => {
         console.error('❌ Failed to start MCP Proxy:', error);
         process.exit(1);
     });

package/dist/proxy.js

@@ -29137,7 +29137,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.21.0" : "dev";
+var VERSION = true ? "1.22.0-beta.1" : "dev";
 var TapTapMCPProxy = class {
   constructor(config2) {
     this.connected = false;
@@ -29646,7 +29646,7 @@ var TapTapMCPProxy = class {
       return result;
     });
     this.server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-      var _a3, _b, _c, _d, _e;
+      var _a3, _b, _c, _d, _e, _f, _g;
       const { name, arguments: args } = request.params;
       const shouldInjectParams = ((_a3 = this.config.options) == null ? void 0 : _a3.inject_params_per_call) ?? true;
       const finalArgs = shouldInjectParams ? this.injectPrivateParams(args) : args;
@@ -29658,6 +29658,7 @@ var TapTapMCPProxy = class {
         timeout: ((_d = this.config.options) == null ? void 0 : _d.tool_call_timeout) ?? 3e5,
         resetTimeoutOnProgress: ((_e = this.config.options) == null ? void 0 : _e.reset_timeout_on_progress) ?? true
       };
+      const forceInjectProgressToken = ((_f = this.config.options) == null ? void 0 : _f.force_inject_progress_token) ?? false;
       if (progressToken !== void 0) {
         callToolOptions.onprogress = (progress) => {
           extra.sendNotification({
@@ -29666,6 +29667,15 @@ var TapTapMCPProxy = class {
           }).catch(() => {
           });
         };
+      } else if (forceInjectProgressToken) {
+        callToolOptions.onprogress = () => {
+        };
+        if ((_g = this.config.options) == null ? void 0 : _g.verbose) {
+          this.log(
+            "debug",
+            `Sentinel onprogress registered for outbound progressToken injection: tool=${name}`
+          );
+        }
       }
       if (!this.connected) {
         if (this.reconnecting) {
@@ -29820,7 +29830,7 @@ function validateConfig(config2) {
 }
 var DEFAULT_LOG_ROOT = "/tmp/taptap-mcp/logs";
 function applyDefaults(config2) {
-  var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o;
+  var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
   const verbose = ((_a3 = config2.options) == null ? void 0 : _a3.verbose) ?? false;
   return {
     server: {
@@ -29843,12 +29853,14 @@ function applyDefaults(config2) {
       reset_timeout_on_progress: ((_e = config2.options) == null ? void 0 : _e.reset_timeout_on_progress) ?? true,
       health_check_interval: ((_f = config2.options) == null ? void 0 : _f.health_check_interval) ?? 3e4,
       enable_cookie_sticky: ((_g = config2.options) == null ? void 0 : _g.enable_cookie_sticky) ?? true,
+      inject_params_per_call: ((_h = config2.options) == null ? void 0 : _h.inject_params_per_call) ?? true,
+      force_inject_progress_token: ((_i = config2.options) == null ? void 0 : _i.force_inject_progress_token) ?? false,
       log: {
-        root: ((_i = (_h = config2.options) == null ? void 0 : _h.log) == null ? void 0 : _i.root) ?? DEFAULT_LOG_ROOT,
-        enabled: ((_k = (_j = config2.options) == null ? void 0 : _j.log) == null ? void 0 : _k.enabled) ?? false,
+        root: ((_k = (_j = config2.options) == null ? void 0 : _j.log) == null ? void 0 : _k.root) ?? DEFAULT_LOG_ROOT,
+        enabled: ((_m = (_l = config2.options) == null ? void 0 : _l.log) == null ? void 0 : _m.enabled) ?? false,
         // verbose=true 时自动使用 debug 级别
-        level: verbose ? "debug" : ((_m = (_l = config2.options) == null ? void 0 : _l.log) == null ? void 0 : _m.level) ?? "info",
-        max_days: ((_o = (_n = config2.options) == null ? void 0 : _n.log) == null ? void 0 : _o.max_days) ?? 7
+        level: verbose ? "debug" : ((_o = (_n = config2.options) == null ? void 0 : _n.log) == null ? void 0 : _o.level) ?? "info",
+        max_days: ((_q = (_p = config2.options) == null ? void 0 : _p.log) == null ? void 0 : _q.max_days) ?? 7
       }
     }
   };