get_activity_leaderboard
Retrieve ranked player lists for Old School RuneScape activities including bosses, minigames, and clue scrolls to compare performance across game modes.
Instructions
Get top players for activities (bosses, minigames, clues)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| activity | Yes | ||
| gamemode | No | ||
| page | No |
Implementation Reference
- src/mcp.ts:15-36 (handler)Core handler function that executes the tool by proxying requests to the remote API 'https://mcp.xiaobenyang.com/api'. The toolName 'get_activity_leaderboard' is passed as 'func' header, and arguments as body. Returns the API response formatted for MCP.const calcXiaoBenYangApi = async function (fullArgs: Record<string, any>) { // 发起 POST 请求 let response = await fetch('https://mcp.xiaobenyang.com/api', { method: 'POST', headers: { 'XBY-APIKEY': apiKey, 'func': fullArgs.toolName, 'mcpid': mcpID }, body: new URLSearchParams(fullArgs) }); const apiResult = await response.text(); return { content: [ { type: "text", text: apiResult // 将字符串结果放入 content 中 } ] } as { [x: string]: unknown; content: [{ type: "text"; text: string }] }; };
- src/mcp.ts:39-48 (handler)Wrapper handler that prepares arguments by adding toolName and calls the core API proxy. Used by the registered tool handlers.const handleXiaoBenYangApi = async (args: Record<string, any>, toolName: string) => { // 校验aid是否存在 if (toolName === undefined || toolName === null) { throw new Error("缺少必要参数 'aid'"); } // 合并参数 const fullArgs = {...args, toolName: toolName}; // 调用API return calcXiaoBenYangApi(fullArgs); };
- src/mcp.ts:50-65 (registration)Registers a tool on the MCP server with the given name, description, and input schema. The handler proxies to the remote service using the tool name.const addToolXiaoBenYangApi = function ( name: string, desc: string, params: Record<string, ZodType> ) { server.registerTool( name, { title: name, description: desc, inputSchema: params, } , async (args: Record<string, any>) => handleXiaoBenYangApi(args, name) ) };
- src/mcp.ts:88-133 (registration)Dynamically fetches tool definitions from remote API for mcpID '1777316659429379', builds Zod input schemas, and registers each tool (including 'get_activity_leaderboard') using the generic proxy handler.const apiDescList = data.tools; for (const apiDesc of apiDescList) { let inputSchema = JSON.parse(apiDesc.inputSchema); const zodDict: Record<string, z.ZodTypeAny> = {}; Object.entries(inputSchema.properties).forEach(([name, propConfig]) => { let zodType; let pt = (propConfig as { type: string }).type; switch (pt) { case 'string': zodType = z.string(); break; case 'number': zodType = z.number(); break; case 'boolean': zodType = z.boolean(); break; case 'integer': zodType = z.int32(); break; case 'array': zodType = z.array(z.any()); break; case 'object': zodType = z.object(z.any()); break; default: zodType = z.any(); } if (inputSchema.required?.includes(name)) { zodDict[name] = zodType; } else { zodDict[name] = zodType.optional(); } }); addToolXiaoBenYangApi( apiDesc.name, apiDesc.description ? apiDesc.description : apiDesc.name, zodDict); } isRegistered = true;
- src/mcp.ts:94-125 (schema)Parses remote tool schema and builds corresponding Zod inputSchema for validation, used for all dynamically registered tools including 'get_activity_leaderboard'.Object.entries(inputSchema.properties).forEach(([name, propConfig]) => { let zodType; let pt = (propConfig as { type: string }).type; switch (pt) { case 'string': zodType = z.string(); break; case 'number': zodType = z.number(); break; case 'boolean': zodType = z.boolean(); break; case 'integer': zodType = z.int32(); break; case 'array': zodType = z.array(z.any()); break; case 'object': zodType = z.object(z.any()); break; default: zodType = z.any(); } if (inputSchema.required?.includes(name)) { zodDict[name] = zodType; } else { zodDict[name] = zodType.optional(); } });