@mikoto_zero/minigame-open-mcp 1.0.0

package/dist/tools/leaderboardTools.js

@@ -0,0 +1,120 @@
+/**
+ * TapTap Minigame Leaderboard Documentation Tools
+ * Each LeaderboardManager API has its own dedicated tool
+ */
+import { searchLeaderboardDocs as searchDocs, getLeaderboardOverview as getOverview, LEADERBOARD_DOCUMENTATION } from '../data/leaderboardDocs.js';
+/**
+ * Get specific API documentation by name
+ */
+function getAPIDoc(categoryKey, apiName) {
+    const category = LEADERBOARD_DOCUMENTATION.categories[categoryKey];
+    if (!category) {
+        return `Category "${categoryKey}" not found`;
+    }
+    const api = category.apis.find(a => a.name === apiName);
+    if (!api) {
+        return `API "${apiName}" not found in category "${categoryKey}"`;
+    }
+    let doc = `# ${api.name}\n\n`;
+    doc += `**Method Signature:**\n\`\`\`javascript\n${api.method}\n\`\`\`\n\n`;
+    doc += `**Description:** ${api.description}\n\n`;
+    if (api.parameters) {
+        doc += `## Parameters\n\n`;
+        for (const [param, desc] of Object.entries(api.parameters)) {
+            doc += `- **\`${param}\`**: ${desc}\n`;
+        }
+        doc += '\n';
+    }
+    if (api.returnValue) {
+        doc += `## Returns\n\n${api.returnValue}\n\n`;
+    }
+    doc += `## Code Example\n\n\`\`\`javascript\n${api.example}\n\`\`\`\n`;
+    return doc;
+}
+// ============ Core API Tools (one for each LeaderboardManager API) ============
+/**
+ * Get documentation for tap.getLeaderboardManager()
+ */
+async function getLeaderboardManager() {
+    return getAPIDoc('initialization', 'tap.getLeaderboardManager');
+}
+/**
+ * Get documentation for openLeaderboard()
+ */
+async function openLeaderboard() {
+    return getAPIDoc('display', 'openLeaderboard');
+}
+/**
+ * Get documentation for submitScores()
+ */
+async function submitScores() {
+    return getAPIDoc('score_submission', 'submitScores');
+}
+/**
+ * Get documentation for loadLeaderboardScores()
+ */
+async function loadLeaderboardScores() {
+    return getAPIDoc('score_query', 'loadLeaderboardScores');
+}
+/**
+ * Get documentation for loadCurrentPlayerLeaderboardScore()
+ */
+async function loadCurrentPlayerScore() {
+    return getAPIDoc('score_query', 'loadCurrentPlayerLeaderboardScore');
+}
+/**
+ * Get documentation for loadPlayerCenteredScores()
+ */
+async function loadPlayerCenteredScores() {
+    return getAPIDoc('score_query', 'loadPlayerCenteredScores');
+}
+// ============ Helper Tools ============
+/**
+ * Search leaderboard documentation by keyword
+ */
+async function searchLeaderboardDocs(args) {
+    const query = args.query?.toLowerCase() || '';
+    if (!query) {
+        return 'Please provide a search keyword.';
+    }
+    const results = searchDocs(query);
+    if (results.length === 0) {
+        return `No results found for "${query}".\n\nTry searching for: initialization, open, submit, load, score, ranking, leaderboard`;
+    }
+    return `**🏆 Search Results for "${query}"**\n\n` + results.join('\n---\n\n');
+}
+/**
+ * Get complete leaderboard system overview
+ */
+async function getLeaderboardOverview() {
+    return getOverview();
+}
+/**
+ * Get integration patterns and best practices
+ */
+async function getLeaderboardPatterns() {
+    const category = LEADERBOARD_DOCUMENTATION.categories['common_scenarios'];
+    if (!category)
+        return 'Common scenarios not found';
+    let doc = `# ${category.title}\n\n${category.description}\n\n`;
+    for (const api of category.apis) {
+        doc += `## ${api.name}\n\n`;
+        doc += `${api.description}\n\n`;
+        doc += `\`\`\`javascript\n${api.example}\n\`\`\`\n\n`;
+    }
+    return doc;
+}
+export const leaderboardTools = {
+    // Core API tools
+    getLeaderboardManager,
+    openLeaderboard,
+    submitScores,
+    loadLeaderboardScores,
+    loadCurrentPlayerScore,
+    loadPlayerCenteredScores,
+    // Helper tools
+    searchLeaderboardDocs,
+    getLeaderboardOverview,
+    getLeaderboardPatterns
+};
+//# sourceMappingURL=leaderboardTools.js.map

package/dist/tools/leaderboardTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboardTools.js","sourceRoot":"","sources":["../../src/tools/leaderboardTools.ts"],"names":[],"mappings":"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"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Local cache utilities for storing app configuration
+ * Separate cache file from tapcode-mcp-h5 to avoid conflicts
+ */
+/**
+ * Cached application information
+ */
+export interface AppCacheInfo {
+    developer_id?: number;
+    developer_name?: string;
+    app_id?: number;
+    app_title?: string;
+    cached_at?: number;
+}
+/**
+ * Get cache file path for minigame leaderboard
+ * Uses different directory from tapcode-mcp-h5 to avoid conflicts
+ */
+export declare function getCachePath(projectPath?: string): string;
+/**
+ * Read cached app information
+ */
+export declare function readAppCache(projectPath?: string): AppCacheInfo | null;
+/**
+ * Save app information to cache
+ */
+export declare function saveAppCache(info: AppCacheInfo, projectPath?: string): void;
+/**
+ * Clear cached app information
+ */
+export declare function clearAppCache(projectPath?: string): void;
+/**
+ * Check if cache is valid (exists and has required fields)
+ */
+export declare function isCacheValid(projectPath?: string): boolean;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqBtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAqB3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAUxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAG1D"}

package/dist/utils/cache.js

@@ -0,0 +1,90 @@
+/**
+ * Local cache utilities for storing app configuration
+ * Separate cache file from tapcode-mcp-h5 to avoid conflicts
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+/**
+ * Get cache file path for minigame leaderboard
+ * Uses different directory from tapcode-mcp-h5 to avoid conflicts
+ */
+export function getCachePath(projectPath) {
+    if (projectPath) {
+        // Project-specific cache
+        const normalizedPath = projectPath.endsWith('/') ? projectPath : projectPath + '/';
+        return path.join(normalizedPath, '.taptap-minigame', 'app.json');
+    }
+    else {
+        // Global cache in user home directory
+        const home = os.homedir();
+        return path.join(home, '.config', 'taptap-minigame', 'app.json');
+    }
+}
+/**
+ * Read cached app information
+ */
+export function readAppCache(projectPath) {
+    const cachePath = getCachePath(projectPath);
+    if (!fs.existsSync(cachePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(cachePath, 'utf8');
+        const cache = JSON.parse(content);
+        // Validate cache has required fields
+        if (cache.developer_id && cache.app_id) {
+            return cache;
+        }
+        return null;
+    }
+    catch (error) {
+        console.error('Failed to read cache:', error);
+        return null;
+    }
+}
+/**
+ * Save app information to cache
+ */
+export function saveAppCache(info, projectPath) {
+    const cachePath = getCachePath(projectPath);
+    const cacheDir = path.dirname(cachePath);
+    try {
+        // Ensure directory exists
+        if (!fs.existsSync(cacheDir)) {
+            fs.mkdirSync(cacheDir, { recursive: true });
+        }
+        // Add timestamp
+        const cacheData = {
+            ...info,
+            cached_at: Date.now()
+        };
+        // Write to file
+        fs.writeFileSync(cachePath, JSON.stringify(cacheData, null, 2), 'utf8');
+    }
+    catch (error) {
+        console.error('Failed to save cache:', error);
+    }
+}
+/**
+ * Clear cached app information
+ */
+export function clearAppCache(projectPath) {
+    const cachePath = getCachePath(projectPath);
+    if (fs.existsSync(cachePath)) {
+        try {
+            fs.unlinkSync(cachePath);
+        }
+        catch (error) {
+            console.error('Failed to clear cache:', error);
+        }
+    }
+}
+/**
+ * Check if cache is valid (exists and has required fields)
+ */
+export function isCacheValid(projectPath) {
+    const cache = readAppCache(projectPath);
+    return !!(cache && cache.developer_id && cache.app_id);
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@mikoto_zero/minigame-open-mcp",
+  "version": "1.0.0",
+  "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",
+  "bin": {
+    "minigame-open-mcp": "bin/minigame-open-mcp"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "ts-node src/server.ts",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "taptap",
+    "minigame",
+    "leaderboard",
+    "ranking",
+    "open-api",
+    "game-development",
+    "documentation",
+    "ai-agent",
+    "openhands"
+  ],
+  "author": "TapTap Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.4.0",
+    "crypto-js": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/crypto-js": "^4.2.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "prettier": "^3.0.0"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "data/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taptap/minigame-open-mcp.git"
+  },
+  "homepage": "https://github.com/taptap/minigame-open-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/taptap/minigame-open-mcp/issues"
+  }
+}