refactor: 统一环境变量命名规范 - 使用 TDS_MCP_* 前缀

重命名环境变量以与 tapcode-mcp-h5 保持一致：
- TAPTAP_MAC_TOKEN → TDS_MCP_MAC_TOKEN
- TAPTAP_CLIENT_ID → TDS_MCP_CLIENT_ID
- TAPTAP_CLIENT_SECRET → TDS_MCP_CLIENT_TOKEN
- TAPTAP_ENV → TDS_MCP_ENV
- TAPTAP_PROJECT_PATH → TDS_MCP_PROJECT_PATH
- TAPTAP_MINIGAME_MCP_VERBOSE → 保持不变

修改范围：
- src/network/httpClient.ts: 环境变量读取和验证
- src/server.ts: 变量名更新
- src/config/toolDefinitions.ts: 工具描述和注释
- src/handlers/leaderboardHandlers.ts: 错误提示信息
- README.md: 所有配置示例
- CLAUDE.md: 所有配置示例和说明

目的：
- 与 tapcode-mcp-h5 项目保持命名一致
- 使用统一的 TDS_MCP_* 前缀
- 便于用户在不同 MCP 服务器间切换

版本：1.0.13

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: MikotoZero

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.13] - 2025-10-10
+
+### Changed
+- 🔄 **Rename environment variables** - Align with tapcode-mcp-h5 naming convention
+  - `TAPTAP_MAC_TOKEN` → `TDS_MCP_MAC_TOKEN`
+  - `TAPTAP_CLIENT_ID` → `TDS_MCP_CLIENT_ID`
+  - `TAPTAP_CLIENT_SECRET` → `TDS_MCP_CLIENT_TOKEN`
+  - `TAPTAP_ENV` → `TDS_MCP_ENV`
+  - `TAPTAP_PROJECT_PATH` → `TDS_MCP_PROJECT_PATH`
+  - `TAPTAP_MINIGAME_MCP_VERBOSE` → (unchanged, kept as is)
+  - Updated all documentation and code to use TDS_MCP_* prefix
+  - Maintains consistency with tapcode-mcp-h5 project
+
 ## [1.0.12] - 2025-10-10
 
 ### Fixed

CLAUDE.md

@@ -84,11 +84,11 @@ TAPTAP_MINIGAME_MCP_VERBOSE=true npm start
 
 ```bash
 # MAC Token（JSON 字符串格式）
-export TAPTAP_MAC_TOKEN='{"kid":"your_kid","token_type":"mac","mac_key":"your_mac_key","mac_algorithm":"hmac-sha-1"}'
+export TDS_MCP_MAC_TOKEN='{"kid":"your_kid","token_type":"mac","mac_key":"your_mac_key","mac_algorithm":"hmac-sha-1"}'
 
 # 客户端配置
-export TAPTAP_CLIENT_ID="your_client_id"
-export TAPTAP_CLIENT_SECRET="your_client_secret"
+export TDS_MCP_CLIENT_ID="your_client_id"
+export TDS_MCP_CLIENT_TOKEN="your_client_secret"
 
 # 启动服务器
 npm start
@@ -102,11 +102,11 @@ npm start
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "${CURRENT_USER_MAC_TOKEN}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_client_secret",
-        "TAPTAP_ENV": "production",
-        "TAPTAP_PROJECT_PATH": "${CURRENT_PROJECT_PATH}",
+        "TDS_MCP_MAC_TOKEN": "${CURRENT_USER_MAC_TOKEN}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_client_secret",
+        "TDS_MCP_ENV": "production",
+        "TDS_MCP_PROJECT_PATH": "${CURRENT_PROJECT_PATH}",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "false"
       }
     }
@@ -122,11 +122,11 @@ npm start
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "${CURRENT_USER_MAC_TOKEN}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_client_secret",
-        "TAPTAP_ENV": "production",
-        "TAPTAP_PROJECT_PATH": "${CURRENT_PROJECT_PATH}",
+        "TDS_MCP_MAC_TOKEN": "${CURRENT_USER_MAC_TOKEN}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_client_secret",
+        "TDS_MCP_ENV": "production",
+        "TDS_MCP_PROJECT_PATH": "${CURRENT_PROJECT_PATH}",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "true"
       }
     }
@@ -146,9 +146,9 @@ npm run lint
 npm run format
 
 # 测试服务器启动
-TAPTAP_MAC_TOKEN='{"kid":"test","token_type":"mac","mac_key":"test","mac_algorithm":"hmac-sha-1"}' \
-TAPTAP_CLIENT_ID=test \
-TAPTAP_CLIENT_SECRET=test \
+TDS_MCP_MAC_TOKEN='{"kid":"test","token_type":"mac","mac_key":"test","mac_algorithm":"hmac-sha-1"}' \
+TDS_MCP_CLIENT_ID=test \
+TDS_MCP_CLIENT_TOKEN=test \
 node dist/server.js
 ```
 
@@ -163,9 +163,9 @@ node dist/server.js
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_secret",
+        "TDS_MCP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_secret",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "false"
       }
     }
@@ -181,9 +181,9 @@ node dist/server.js
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_secret",
+        "TDS_MCP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_secret",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "true"
       }
     }
@@ -245,18 +245,18 @@ node dist/server.js
 ### 环境变量详解
 
 **核心环境变量（必需）**：
-- `TAPTAP_MAC_TOKEN`: 用户 MAC Token，JSON 字符串格式
+- `TDS_MCP_MAC_TOKEN`: 用户 MAC Token，JSON 字符串格式
   ```json
   {"kid":"abc123","token_type":"mac","mac_key":"secret","mac_algorithm":"hmac-sha-1"}
   ```
-- `TAPTAP_CLIENT_ID`: 客户端 ID，用于 API 调用
-- `TAPTAP_CLIENT_SECRET`: 客户端密钥，用于请求签名
+- `TDS_MCP_CLIENT_ID`: 客户端 ID，用于 API 调用
+- `TDS_MCP_CLIENT_TOKEN`: 客户端密钥，用于请求签名
 
 **可选配置**：
-- `TAPTAP_ENV`: 环境选择，`production`（默认）或 `rnd`
+- `TDS_MCP_ENV`: 环境选择，`production`（默认）或 `rnd`
   - production: `https://agent.tapapis.cn`
   - rnd: `https://agent.api.xdrnd.cn`
-- `TAPTAP_PROJECT_PATH`: 项目路径，用于本地缓存
+- `TDS_MCP_PROJECT_PATH`: 项目路径，用于本地缓存
 - `TAPTAP_MINIGAME_MCP_VERBOSE`: 详细日志模式，设置为 `true` 或 `1` 启用
   - 记录所有工具调用的输入和输出
   - 记录所有 HTTP 请求和响应
@@ -526,4 +526,4 @@ npm publish --access public
 - 环境变量名称使用 TAPTAP_ 前缀
 - MAC Token 必须是 JSON 字符串格式
 - 请求签名使用两层机制（MAC + X-Tap-Sign）
-- 默认环境为 production，可通过 TAPTAP_ENV 切换
+- 默认环境为 production，可通过 TDS_MCP_ENV 切换

README.md

@@ -64,9 +64,9 @@ Add to `~/.config/claude-desktop/config.json`:
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_client_secret",
+        "TDS_MCP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_client_secret",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "false"
       }
     }
@@ -83,9 +83,9 @@ Add to `~/.config/claude-desktop/config.json`:
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_client_secret",
+        "TDS_MCP_MAC_TOKEN": "{\"kid\":\"your_kid\",\"token_type\":\"mac\",\"mac_key\":\"your_key\",\"mac_algorithm\":\"hmac-sha-1\"}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_client_secret",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "true"
       }
     }
@@ -102,10 +102,10 @@ Add to `~/.config/claude-desktop/config.json`:
       "command": "npx",
       "args": ["@mikoto_zero/minigame-open-mcp"],
       "env": {
-        "TAPTAP_MAC_TOKEN": "${CURRENT_USER_MAC_TOKEN}",
-        "TAPTAP_CLIENT_ID": "your_client_id",
-        "TAPTAP_CLIENT_SECRET": "your_client_secret",
-        "TAPTAP_PROJECT_PATH": "${CURRENT_PROJECT_PATH}",
+        "TDS_MCP_MAC_TOKEN": "${CURRENT_USER_MAC_TOKEN}",
+        "TDS_MCP_CLIENT_ID": "your_client_id",
+        "TDS_MCP_CLIENT_TOKEN": "your_client_secret",
+        "TDS_MCP_PROJECT_PATH": "${CURRENT_PROJECT_PATH}",
         "TAPTAP_MINIGAME_MCP_VERBOSE": "false"
       }
     }
@@ -116,13 +116,13 @@ Add to `~/.config/claude-desktop/config.json`:
 ### Environment Variables
 
 **Required:**
-- `TAPTAP_MAC_TOKEN` - MAC Token in JSON format for authentication
-- `TAPTAP_CLIENT_ID` - Client ID for API access
-- `TAPTAP_CLIENT_SECRET` - Client secret for request signing
+- `TDS_MCP_MAC_TOKEN` - MAC Token in JSON format for authentication
+- `TDS_MCP_CLIENT_ID` - Client ID for API access
+- `TDS_MCP_CLIENT_TOKEN` - Client secret for request signing
 
 **Optional:**
-- `TAPTAP_ENV` - Environment: `production` (default) or `rnd`
-- `TAPTAP_PROJECT_PATH` - Project path for local caching
+- `TDS_MCP_ENV` - Environment: `production` (default) or `rnd`
+- `TDS_MCP_PROJECT_PATH` - Project path for local caching
 - `TAPTAP_MINIGAME_MCP_VERBOSE` - Detailed logging: `true` or `false` (default)
 
 **Debugging:**
@@ -229,7 +229,7 @@ Signature = HMAC-SHA256(
   url + "\n" +
   x-tap-headers + "\n" +
   body + "\n",
-  TAPTAP_CLIENT_SECRET
+  TDS_MCP_CLIENT_TOKEN
 )
 ```
 
@@ -248,7 +248,7 @@ Developer ID and App ID are automatically managed:
 - **Production** (default): `https://agent.tapapis.cn`
 - **RND**: `https://agent.api.xdrnd.cn`
 
-Switch via `TAPTAP_ENV` environment variable.
+Switch via `TDS_MCP_ENV` environment variable.
 
 ## Requirements
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikoto_zero/minigame-open-mcp",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "type": "module",
   "description": "TapTap Minigame Open API MCP Server - Documentation and Management APIs for TapTap minigame (Leaderboard, and more features coming)",
   "main": "dist/server.js",

src/config/toolDefinitions.ts

@@ -123,7 +123,7 @@ Use this as the first step for any leaderboard integration request.`,
     // 🔧 Environment Check Tool
     {
       name: 'check_environment',
-      description: 'Check environment configuration and user authentication status. Use this to verify if TAPTAP_MAC_TOKEN and TAPTAP_CLIENT_ID are configured.',
+      description: 'Check environment configuration and user authentication status. Use this to verify if TDS_MCP_MAC_TOKEN and TDS_MCP_CLIENT_ID are configured.',
       inputSchema: {
         type: 'object',
         properties: {}
@@ -158,7 +158,7 @@ Use this as the first step for any leaderboard integration request.`,
       }
     },
 
-    // ⚙️ Leaderboard Management Tools (requires TAPTAP_MAC_TOKEN, TAPTAP_CLIENT_ID, TAPTAP_CLIENT_SECRET)
+    // ⚙️ Leaderboard Management Tools (requires TDS_MCP_MAC_TOKEN, TDS_MCP_CLIENT_ID, TDS_MCP_CLIENT_TOKEN)
     {
       name: 'create_leaderboard',
       description: `Create a new leaderboard on TapTap server. Use this AFTER checking existing leaderboards with list_leaderboards.
@@ -267,7 +267,7 @@ Auto-fetches developer_id and app_id if not provided. Returns leaderboard_id for
       }
     },
 
-    // 🔑 User Data Tools (requires TAPTAP_MAC_TOKEN)
+    // 🔑 User Data Tools (requires TDS_MCP_MAC_TOKEN)
     {
       name: 'get_user_leaderboard_scores',
       description: 'Get actual user leaderboard score data from TapTap API (requires user login). Use this when user wants to see their own scores or ranking positions. Falls back to documentation mode if token is not provided.',

src/handlers/leaderboardHandlers.ts

@@ -182,7 +182,7 @@ export async function createLeaderboard(
                `系统会自动从 /level/v1/list 接口获取您的应用信息。\n` +
                `如果失败，请检查：\n` +
                `1. 用户是否已创建应用/游戏\n` +
-               `2. TAPTAP_MAC_TOKEN 是否有效\n` +
+               `2. TDS_MCP_MAC_TOKEN 是否有效\n` +
                `3. 您也可以手动指定 developer_id 和 app_id 参数`;
       }
     }
@@ -230,9 +230,9 @@ export async function createLeaderboard(
     } else if (errorMsg.includes('Unauthorized') || errorMsg.includes('401')) {
       specificHelp = `\n🔑 **认证错误：**\n` +
                      `请检查环境变量:\n` +
-                     `- TAPTAP_MAC_TOKEN\n` +
-                     `- TAPTAP_CLIENT_ID\n` +
-                     `- TAPTAP_CLIENT_SECRET`;
+                     `- TDS_MCP_MAC_TOKEN\n` +
+                     `- TDS_MCP_CLIENT_ID\n` +
+                     `- TDS_MCP_CLIENT_TOKEN`;
     } else if (errorMsg.includes('403') || errorMsg.includes('Forbidden')) {
       specificHelp = `\n🚫 **权限错误：**\n` +
                      `当前用户可能没有创建排行榜的权限，请检查开发者账号权限。`;
@@ -318,7 +318,7 @@ export async function getUserLeaderboardScores(
   context: HandlerContext
 ): Promise<string> {
   if (!context.macToken || !context.macToken.kid) {
-    return `❌ 此功能需要用户登录 TapTap\n请设置 TAPTAP_MAC_TOKEN 环境变量\n\n降级为文档模式:\n${await leaderboardTools.getLeaderboardOverview()}`;
+    return `❌ 此功能需要用户登录 TapTap\n请设置 TDS_MCP_MAC_TOKEN 环境变量\n\n降级为文档模式:\n${await leaderboardTools.getLeaderboardOverview()}`;
   }
 
   try {

src/network/httpClient.ts

@@ -21,21 +21,21 @@ export class ApiConfig {
   public readonly environment: 'rnd' | 'production';
 
   private constructor() {
-    // Required environment variables
-    const macTokenStr = process.env.TAPTAP_MAC_TOKEN || '';
-    this.clientId = process.env.TAPTAP_CLIENT_ID || '';
-    this.clientSecret = process.env.TAPTAP_CLIENT_SECRET || '';
+    // Required environment variables (TDS_MCP_* prefix for consistency)
+    const macTokenStr = process.env.TDS_MCP_MAC_TOKEN || '';
+    this.clientId = process.env.TDS_MCP_CLIENT_ID || '';
+    this.clientSecret = process.env.TDS_MCP_CLIENT_TOKEN || '';  // Using CLIENT_TOKEN to match tapcode-mcp-h5
 
     // Parse MAC Token from JSON string
     try {
       this.macToken = macTokenStr ? JSON.parse(macTokenStr) : {} as MacToken;
     } catch (error) {
-      process.stderr.write('❌ Failed to parse TAPTAP_MAC_TOKEN: Invalid JSON format\n');
+      process.stderr.write('❌ Failed to parse TDS_MCP_MAC_TOKEN: Invalid JSON format\n');
       process.exit(1);
     }
 
     // Optional: default to production
-    this.environment = (process.env.TAPTAP_ENV === 'rnd') ? 'rnd' : 'production';
+    this.environment = (process.env.TDS_MCP_ENV === 'rnd') ? 'rnd' : 'production';
 
     // Set API base URL based on environment
     this.apiBaseUrl = this.environment === 'production'
@@ -50,20 +50,20 @@ export class ApiConfig {
     const missing: string[] = [];
 
     if (!this.macToken.kid || !this.macToken.mac_key) {
-      missing.push('TAPTAP_MAC_TOKEN (must be valid JSON with kid and mac_key)');
+      missing.push('TDS_MCP_MAC_TOKEN (must be valid JSON with kid and mac_key)');
     }
 
     if (!this.clientId) {
-      missing.push('TAPTAP_CLIENT_ID');
+      missing.push('TDS_MCP_CLIENT_ID');
     }
 
     if (!this.clientSecret) {
-      missing.push('TAPTAP_CLIENT_SECRET');
+      missing.push('TDS_MCP_CLIENT_TOKEN');
     }
 
     if (missing.length > 0) {
       process.stderr.write(`❌ Missing required environment variables: ${missing.join(', ')}\n`);
-      process.stderr.write('\nExample TAPTAP_MAC_TOKEN format:\n');
+      process.stderr.write('\nExample TDS_MCP_MAC_TOKEN format:\n');
       process.stderr.write('{"kid":"abc123","token_type":"mac","mac_key":"secret_key","mac_algorithm":"hmac-sha-1"}\n');
       process.exit(1);
     }
@@ -82,10 +82,10 @@ export class ApiConfig {
 
   public getConfigStatus(): Record<string, string> {
     return {
-      'TAPTAP_MAC_TOKEN': this.macToken.kid ? `✅ 已配置 (kid: ${this.macToken.kid.substring(0, 8)}...)` : '❌ 未配置',
-      'TAPTAP_CLIENT_ID': this.clientId ? '✅ 已配置' : '❌ 未配置',
-      'TAPTAP_CLIENT_SECRET': this.clientSecret ? '✅ 已配置' : '❌ 未配置',
-      'TAPTAP_ENV': `${this.environment} (${this.apiBaseUrl})`,
+      'TDS_MCP_MAC_TOKEN': this.macToken.kid ? `✅ 已配置 (kid: ${this.macToken.kid.substring(0, 8)}...)` : '❌ 未配置',
+      'TDS_MCP_CLIENT_ID': this.clientId ? '✅ 已配置' : '❌ 未配置',
+      'TDS_MCP_CLIENT_TOKEN': this.clientSecret ? '✅ 已配置' : '❌ 未配置',
+      'TDS_MCP_ENV': `${this.environment} (${this.apiBaseUrl})`,
     };
   }
 }

src/server.ts

@@ -29,8 +29,8 @@ import * as environmentHandlers from './handlers/environmentHandlers.js';
 
 // 环境变量配置
 const apiConfig = ApiConfig.getInstance();
-const TAPTAP_MAC_TOKEN = apiConfig.macToken;
-const TAPTAP_PROJECT_PATH = process.env.TAPTAP_PROJECT_PATH;
+const TDS_MCP_MAC_TOKEN = apiConfig.macToken;
+const TDS_MCP_PROJECT_PATH = process.env.TDS_MCP_PROJECT_PATH;
 
 /**
  * Handler context type
@@ -51,13 +51,13 @@ class TapTapMinigameMCPServer {
     this.server = new Server(
       {
         name: 'taptap-minigame-mcp',
-        version: '1.0.12',
+        version: '1.0.13',
       }
     );
 
     this.context = {
-      projectPath: TAPTAP_PROJECT_PATH,
-      macToken: TAPTAP_MAC_TOKEN
+      projectPath: TDS_MCP_PROJECT_PATH,
+      macToken: TDS_MCP_MAC_TOKEN
     };
 
     this.setupHandlers();