/** * op.gg MCP Client — calls the public op.gg MCP server at https://mcp-api.op.gg/mcp * Uses JSON-RPC 2.0 over StreamableHTTP (MCP protocol). * No API key needed. */ import type { RegionInfo, SummonerProfile, MatchEntry, MatchParticipant, MatchParticipantStats, TeamStat, } from './types.js'; const MCP_URL = 'https://mcp-api.op.gg/mcp'; let rpcId = 1; // ── Regions ── export const REGIONS: RegionInfo[] = [ { code: 'EUW', label: 'EU West' }, { code: 'EUNE', label: 'EU Nordic & East' }, { code: 'NA', label: 'North America' }, { code: 'KR', label: 'Korea' }, { code: 'BR', label: 'Brazil' }, { code: 'LAN', label: 'Latin America North' }, { code: 'LAS', label: 'Latin America South' }, { code: 'TR', label: 'Turkey' }, { code: 'RU', label: 'Russia' }, { code: 'JP', label: 'Japan' }, { code: 'OCE', label: 'Oceania' }, { code: 'PH', label: 'Philippines' }, { code: 'SG', label: 'Singapore' }, { code: 'TH', label: 'Thailand' }, { code: 'TW', label: 'Taiwan' }, { code: 'VN', label: 'Vietnam' }, ]; // ── MCP call helper ── async function mcpCall(toolName: string, args: Record): Promise { const id = rpcId++; const body = { jsonrpc: '2.0', id, method: 'tools/call', params: { name: toolName, arguments: args }, }; const res = await fetch(MCP_URL, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Accept': 'application/json, text/event-stream', }, body: JSON.stringify(body), }); if (!res.ok) { throw new Error(`MCP HTTP ${res.status}: ${res.statusText}`); } const json = await res.json() as any; if (json.error) { const msg = json.error.message ?? JSON.stringify(json.error); throw new Error(msg); } // MCP tools return content as an array of content blocks const text = json.result?.content?.[0]?.text; if (!text) throw new Error('Empty MCP response'); return text; } // ── Response parser ── // op.gg MCP returns a custom class-notation format, not pure JSON. // We need to parse the structured text into usable data. function parseClassNotation(text: string): any { // The response format is like: // class ClassName: field1,field2 // ClassName(Data(...)) // // We need to extract the actual data. The data part after the class // definitions is a nested constructor-call format. // Strategy: find the last line that starts with the root class name // and parse the nested parentheses structure. const lines = text.split('\n'); // Find class definitions and the data line const classDefs: Map = new Map(); let dataLine = ''; for (const line of lines) { const classMatch = line.match(/^class (\w+): (.+)$/); if (classMatch) { classDefs.set(classMatch[1], classMatch[2].split(',')); continue; } if (line.trim()) { dataLine = line.trim(); } } if (!dataLine) throw new Error('No data in MCP response'); // Parse the constructor-call notation recursively return parseConstructor(dataLine, classDefs); } function parseConstructor(input: string, classDefs: Map): any { // Try to match ClassName(...) const ctorMatch = input.match(/^(\w+)\((.+)\)$/s); if (!ctorMatch) { // It's a primitive value return parsePrimitive(input); } const className = ctorMatch[1]; const innerContent = ctorMatch[2]; const fields = classDefs.get(className); if (!fields) { // Unknown class, try to parse inner as a value return parseConstructor(innerContent, classDefs); } // Split the inner content by top-level commas (respecting nested parens/brackets/strings) const values = splitTopLevel(innerContent); const obj: Record = {}; for (let i = 0; i < fields.length && i < values.length; i++) { const fieldName = fields[i].trim(); const rawVal = values[i].trim(); if (fieldName.endsWith('[]')) { // Array field — clean field name const cleanName = fieldName.replace('[]', ''); obj[cleanName] = parseArrayValue(rawVal, classDefs); } else { obj[fieldName] = parseValue(rawVal, classDefs); } } return obj; } function parseArrayValue(input: string, classDefs: Map): any[] { // Array notation: [item1,item2,...] or [ClassName(...),ClassName(...)] if (input === '[]' || input === 'null' || input === 'None') return []; if (input.startsWith('[') && input.endsWith(']')) { const inner = input.slice(1, -1).trim(); if (!inner) return []; const items = splitTopLevel(inner); return items.map(item => parseValue(item.trim(), classDefs)); } // Single item not wrapped in brackets return [parseValue(input, classDefs)]; } function parseValue(input: string, classDefs: Map): any { if (!input) return null; // Check if it's a constructor call const ctorMatch = input.match(/^(\w+)\(/); if (ctorMatch && classDefs.has(ctorMatch[1])) { return parseConstructor(input, classDefs); } // Check if it's an array if (input.startsWith('[') && input.endsWith(']')) { return parseArrayValue(input, classDefs); } return parsePrimitive(input); } function parsePrimitive(input: string): any { if (input === 'null' || input === 'None') return null; if (input === 'true' || input === 'True') return true; if (input === 'false' || input === 'False') return false; // Quoted string if ((input.startsWith('"') && input.endsWith('"')) || (input.startsWith("'") && input.endsWith("'"))) { return input.slice(1, -1); } // Number const num = Number(input); if (!isNaN(num) && input !== '') return num; // Raw string return input; } function splitTopLevel(input: string): string[] { const results: string[] = []; let depth = 0; let inString = false; let stringChar = ''; let current = ''; for (let i = 0; i < input.length; i++) { const ch = input[i]; const prev = i > 0 ? input[i - 1] : ''; if (inString) { current += ch; if (ch === stringChar && prev !== '\\') { inString = false; } continue; } if (ch === '"' || ch === "'") { inString = true; stringChar = ch; current += ch; continue; } if (ch === '(' || ch === '[') { depth++; current += ch; continue; } if (ch === ')' || ch === ']') { depth--; current += ch; continue; } if (ch === ',' && depth === 0) { results.push(current); current = ''; continue; } current += ch; } if (current.trim()) results.push(current); return results; } // ── Public API functions ── export async function getProfile( gameName: string, tagLine: string, region: string, ): Promise { const raw = await mcpCall('lol_get_summoner_profile', { game_name: gameName, tag_line: tagLine, region, lang: 'en_US', desired_output_fields: [ 'data.summoner.game_name', 'data.summoner.tagline', 'data.summoner.level', 'data.summoner.profile_image_url', 'data.summoner.updated_at', 'data.summoner.league_stats[].tier_info.{tier,division,lp,tier_image_url}', 'data.summoner.league_stats[].{game_type,win,lose,is_hot_streak}', 'data.summoner.ladder_rank.{rank,total}', 'data.summoner.most_champions.champion_stats[].{champion_name,id,play,win,lose,kill,death,assist}', 'data.summoner.most_champions.{game_type,play,win,lose}', ], }); const parsed = parseClassNotation(raw); // Navigate to summoner data (may be nested in data.summoner or similar) const summoner = parsed?.summoner ?? parsed?.data?.summoner ?? parsed; return { game_name: summoner.game_name ?? gameName, tagline: summoner.tagline ?? tagLine, level: summoner.level ?? 0, profile_image_url: summoner.profile_image_url ?? '', league_stats: Array.isArray(summoner.league_stats) ? summoner.league_stats : [], ladder_rank: summoner.ladder_rank ?? { rank: null, total: null }, most_champions: summoner.most_champions ?? { game_type: '', play: 0, win: 0, lose: 0, champion_stats: [] }, updated_at: summoner.updated_at ?? '', }; } export async function getMatches( gameName: string, tagLine: string, region: string, limit = 10, ): Promise { const raw = await mcpCall('lol_list_summoner_matches', { game_name: gameName, tag_line: tagLine, region, lang: 'en_US', limit, desired_output_fields: [ 'data.game_history[].{id,created_at,game_length_second,game_type,game_map}', 'data.game_history[].average_tier_info.{tier,division}', 'data.game_history[].participants[].{champion_name,champion_id,items[],items_names[],position,team_key,spells[]}', 'data.game_history[].participants[].stats.{kill,death,assist,minion_kill,neutral_minion_kill,gold_earned,total_damage_dealt_to_champions,total_damage_taken,ward_place,vision_wards_bought_in_game,champion_level,op_score,op_score_rank,result}', 'data.game_history[].participants[].summoner.{game_name,tagline}', 'data.game_history[].teams[].{key,banned_champions_names[]}', 'data.game_history[].teams[].game_stat.{is_win,baron_kill,dragon_kill,tower_kill,champion_kill,gold_earned,inhibitor_kill,rift_herald_kill}', ], }); const parsed = parseClassNotation(raw); const history = parsed?.game_history ?? parsed?.data?.game_history ?? []; return Array.isArray(history) ? history : []; } export async function getMatchDetail( gameId: string, createdAt: string, region: string, ): Promise { const raw = await mcpCall('lol_get_summoner_game_detail', { game_id: gameId, created_at: createdAt, region, lang: 'en_US', desired_output_fields: [ 'data.game_detail.{id,created_at,game_length_second,game_type,game_map}', 'data.game_detail.average_tier_info.{tier,division}', 'data.game_detail.participants[].{champion_name,champion_id,items[],items_names[],position,team_key,spells[]}', 'data.game_detail.participants[].stats.{kill,death,assist,minion_kill,neutral_minion_kill,gold_earned,total_damage_dealt_to_champions,total_damage_taken,ward_place,vision_wards_bought_in_game,champion_level,op_score,op_score_rank,result}', 'data.game_detail.participants[].summoner.{game_name,tagline}', 'data.game_detail.teams[].{key,banned_champions_names[]}', 'data.game_detail.teams[].game_stat.{is_win,baron_kill,dragon_kill,tower_kill,champion_kill,gold_earned,inhibitor_kill,rift_herald_kill}', ], }); const parsed = parseClassNotation(raw); return parsed?.game_detail ?? parsed?.data?.game_detail ?? null; }