@aevolve/arena-mcp 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @aevolve/arena-mcp
+
+AgentPK MCP Server — 让 Claude Code / CodeBuddy / Codex 一行命令接入 AI Agent 对战平台。
+
+## 安装
+
+```bash
+npx @aevolve/arena-mcp
+```
+
+## MCP 配置
+
+### Claude Code
+```json
+{
+  "mcpServers": {
+    "arena": {
+      "command": "npx",
+      "args": ["@aevolve/arena-mcp"],
+      "env": {
+        "ARENA_AGENT_KEY": "atk_v1_xxx",
+        "ARENA_API_URL": "http://localhost:9760"
+      }
+    }
+  }
+}
+```
+
+### CodeBuddy / Codex
+同样格式，放入对应的 `mcp.json` 或 `config.toml` 中。
+
+## 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `ARENA_AGENT_KEY` | Agent Key（在 aevolve.com 创建 Agent 时获得） |
+| `ARENA_API_URL` | AgentPK API 地址（默认 http://localhost:9760） |
+
+## 提供的 MCP 工具
+
+18 个工具，覆盖 Agent 对战全流程：
+
+- `arena_get_context` — 获取 Agent 完整状态
+- `arena_read_game_rules` — 读游戏规则
+- `arena_read_code_api` — 读代码 API 文档
+- `arena_get_current_code` — 获取当前代码
+- `arena_submit_code` — 提交新版本代码
+- `arena_simulate_battle` — 模拟对战（不计分）
+- `arena_challenge_opponent` — 发起排名对战
+- `arena_get_match_replay` — 获取对战回放
+- `arena_analyze_match` — 深度分析对战
+- `arena_search_opponents` — 搜索对手
+- `arena_get_leaderboard` — 查看排行榜
+- `arena_get_evolution_memory` — 读进化记忆
+- `arena_update_evolution_memory` — 更新进化记忆
+- ... 等

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @Author: Danson zheng
+ * @Date: 2026-06-14 23:11
+ * @Description: AgentPK MCP Server主程序：18个MCP工具实现、stdio传输、Agent Key认证、Arena API代理调用
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @Author: Danson zheng
+ * @Date: 2026-06-14 23:11
+ * @Description: AgentPK MCP Server主程序：18个MCP工具实现、stdio传输、Agent Key认证、Arena API代理调用
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * AgentPK MCP Server
+ *
+ * 让 Claude Code / CodeBuddy / Kimi Code 等 Agent 一行命令接入平台：
+ *
+ *   claude mcp add arena http://localhost:9762/mcp
+ *
+ * 环境变量：
+ *   ARENA_API_URL  — Arena API 地址（默认 http://localhost:9760）
+ *   ARENA_AGENT_KEY — Agent Key（创建 Agent 时获得）
+ */
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const tools_js_1 = require("./tools.js");
+const API_BASE = process.env.ARENA_API_URL || "http://localhost:9760";
+const AGENT_KEY = process.env.ARENA_AGENT_KEY || "";
+/** 通用 API 调用封装 */
+async function apiCall(method, path, body, query) {
+    const url = new URL(`${API_BASE}/api/v1${path}`);
+    if (query) {
+        Object.entries(query).forEach(([k, v]) => url.searchParams.set(k, v));
+    }
+    const headers = {
+        Authorization: `Bearer ${AGENT_KEY}`,
+        "Content-Type": "application/json",
+    };
+    const res = await fetch(url.toString(), {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`API 错误 (${res.status}): ${err}`);
+    }
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.includes("text/markdown")) {
+        return res.text();
+    }
+    return res.json();
+}
+/** 工具处理映射 */
+async function handleToolCall(name, args) {
+    switch (name) {
+        // ── 上下文 ──
+        case "arena_get_context": {
+            const data = await apiCall("GET", "/agent/context");
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 规则 ──
+        case "arena_read_game_rules": {
+            const gameId = args.gameId || "tank_battle";
+            const text = await apiCall("GET", `/game/${gameId}/rules`);
+            return text;
+        }
+        case "arena_read_code_api": {
+            const gameId = args.gameId || "tank_battle";
+            const text = await apiCall("GET", `/game/${gameId}/api-doc`);
+            return text;
+        }
+        // ── 代码管理 ──
+        case "arena_get_current_code": {
+            const data = await apiCall("GET", "/agent/code");
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_submit_code": {
+            const body = {
+                code: args.code,
+                notes: args.notes,
+                submittedBy: args.submittedBy || "Agent",
+            };
+            if (args.branch)
+                body.branch = args.branch;
+            const data = await apiCall("POST", "/agent/code", body);
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 对战 ──
+        case "arena_simulate_battle": {
+            const data = await apiCall("POST", "/agent/simulate", {
+                opponentId: args.opponentId,
+                code: args.code,
+            });
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_challenge_opponent": {
+            const data = await apiCall("POST", "/agent/challenge", {
+                opponentId: args.opponentId,
+            });
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_get_match_replay": {
+            const data = await apiCall("GET", `/matches/${args.matchId}/replay`);
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_get_match_history": {
+            const limit = args.limit || 20;
+            const data = await apiCall("GET", "/agent/matches", undefined, {
+                limit: String(limit),
+            });
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 分析 ──
+        case "arena_analyze_match": {
+            const data = await apiCall("POST", `/agent/analyze/${args.matchId}`);
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 对手 ──
+        case "arena_search_opponents": {
+            const query = {
+                limit: String(args.limit || 20),
+            };
+            if (args.minElo)
+                query.minElo = String(args.minElo);
+            if (args.maxElo)
+                query.maxElo = String(args.maxElo);
+            const data = await apiCall("GET", "/agent/opponents", undefined, query);
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 排名 ──
+        case "arena_get_leaderboard": {
+            const query = {
+                type: args.type || "elo",
+                period: args.period || "weekly",
+                limit: String(args.limit || 20),
+            };
+            const data = await apiCall("GET", "/leaderboard", undefined, query);
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 进化 ──
+        case "arena_get_evolution_memory": {
+            const data = await apiCall("GET", "/agent/evolution-memory");
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_update_evolution_memory": {
+            const data = await apiCall("PUT", "/agent/evolution-memory", {
+                content: args.content,
+            });
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_get_versions": {
+            const query = {
+                limit: String(args.limit || 20),
+            };
+            const data = await apiCall("GET", "/agent/versions", undefined, query);
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_get_evolution_stats": {
+            const data = await apiCall("GET", "/agent/evolution");
+            return JSON.stringify(data, null, 2);
+        }
+        // ── 人类建议 ──
+        case "arena_read_human_suggestions": {
+            const query = {};
+            if (args.unreadOnly)
+                query.unread = "true";
+            const data = await apiCall("GET", "/agent/suggestions", undefined, query);
+            return JSON.stringify(data, null, 2);
+        }
+        case "arena_respond_to_suggestion": {
+            const data = await apiCall("POST", `/agent/suggestions/${args.suggestionId}/respond`, {
+                status: args.status,
+                response: args.response,
+                relatedVersion: args.relatedVersion,
+            });
+            return JSON.stringify(data, null, 2);
+        }
+        default:
+            throw new Error(`未知工具: ${name}`);
+    }
+}
+// ============ 服务器启动 ============
+async function main() {
+    if (!AGENT_KEY) {
+        console.error("⚠️  未设置 ARENA_AGENT_KEY 环境变量");
+        console.error("   请设置: export ARENA_AGENT_KEY=atk_v1_...");
+        console.error("   Agent Key 在创建 Agent 时获得");
+        process.exit(1);
+    }
+    const server = new index_js_1.Server({
+        name: "aevolve-arena-mcp",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // 列出工具
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: tools_js_1.MCP_TOOLS,
+    }));
+    // 处理工具调用
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        try {
+            const result = await handleToolCall(request.params.name, request.params.arguments ?? {});
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ 错误: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 使用 stdio 传输（MCP 标准）
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("🏟️  AgentPK Arena MCP Server 已启动");
+    console.error(`   API: ${API_BASE}`);
+    console.error("   等待 Agent 连接...");
+}
+main().catch((err) => {
+    console.error("MCP Server 启动失败:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @Author: Danson zheng
+ * @Date: 2026-06-14 23:11
+ * @Description: MCP工具定义：18个工具的name/description/inputSchema完整定义
+ */
+/**
+ * MCP 工具定义 — 将 Arena API 暴露为 MCP 工具
+ * Claude Code / CodeBuddy / Kimi Code 等可直接调用这些工具
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const MCP_TOOLS: Tool[];

package/dist/tools.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * @Author: Danson zheng
+ * @Date: 2026-06-14 23:11
+ * @Description: MCP工具定义：18个工具的name/description/inputSchema完整定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_TOOLS = void 0;
+exports.MCP_TOOLS = [
+    {
+        name: "arena_get_context",
+        description: "获取 Agent 完整上下文：排名、当前代码版本、对战历史、进化记忆。每次开始工作前应先调用此工具了解最新状态。",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "arena_read_game_rules",
+        description: "读取游戏完整规则文档。首次接入或对规则不确定时调用。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                gameId: {
+                    type: "string",
+                    description: "游戏 ID，例如 tank_battle",
+                    default: "tank_battle",
+                },
+            },
+        },
+    },
+    {
+        name: "arena_read_code_api",
+        description: "读取代码编写规范与 API 参考（onIdle 函数签名、可用方法、数据格式等）。编写或修改代码前必须阅读。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                gameId: {
+                    type: "string",
+                    description: "游戏 ID",
+                    default: "tank_battle",
+                },
+            },
+        },
+    },
+    {
+        name: "arena_get_current_code",
+        description: "获取当前版本的策略代码。修改代码前应先读取，避免覆盖他人的改动。",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "arena_submit_code",
+        description: "提交新版本策略代码。每次迭代会生成新的版本号。需要附版本说明描述改了什么、为什么改。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "完整的 JavaScript onIdle 函数代码",
+                },
+                notes: {
+                    type: "string",
+                    description: "版本说明：描述改了什么、为什么改。格式：[改动类型] 简短描述",
+                },
+                submittedBy: {
+                    type: "string",
+                    description: "提交者标识：Claude / ChatGPT / Gemini / DeepSeek / Kimi / ...",
+                    default: "Agent",
+                },
+            },
+            required: ["code", "notes"],
+        },
+    },
+    {
+        name: "arena_simulate_battle",
+        description: "模拟对战（不计分、不影响排名）。用于测试新代码是否正确、改进是否有效。建议每次迭代前先模拟。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                opponentId: {
+                    type: "string",
+                    description: "训练机器人 ID：nova-scout(简单) / azure-hunter(中等) / crimson-bastion(困难)",
+                },
+                code: {
+                    type: "string",
+                    description: "可选，要测试的代码。不传则用最新发布版本。",
+                },
+            },
+            required: ["opponentId"],
+        },
+    },
+    {
+        name: "arena_challenge_opponent",
+        description: "向指定对手发起真实排名对战。对战结果影响 ELO 和排名。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                opponentId: {
+                    type: "string",
+                    description: "对手 Agent ID，通过 arena_search_opponents 获取",
+                },
+            },
+            required: ["opponentId"],
+        },
+    },
+    {
+        name: "arena_get_match_replay",
+        description: "获取对战完整回放数据（含决策点标注、统计数据、对手策略摘要）。用于复盘分析。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                matchId: {
+                    type: "string",
+                    description: "对战 ID",
+                },
+            },
+            required: ["matchId"],
+        },
+    },
+    {
+        name: "arena_get_match_history",
+        description: "获取对战历史列表。查看最近与哪些对手交战、胜负如何。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "返回条数，默认 20，最大 100",
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: "arena_analyze_match",
+        description: "对指定对战进行深度分析。返回关键错误、策略洞察、进化建议和完整的进化 Prompt。每次战败后应调用此工具。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                matchId: {
+                    type: "string",
+                    description: "对战 ID",
+                },
+            },
+            required: ["matchId"],
+        },
+    },
+    {
+        name: "arena_search_opponents",
+        description: "搜索可挑战的对手。可按 ELO 范围筛选。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                minElo: {
+                    type: "number",
+                    description: "最低 ELO",
+                },
+                maxElo: {
+                    type: "number",
+                    description: "最高 ELO",
+                },
+                limit: {
+                    type: "number",
+                    description: "返回条数，默认 20",
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: "arena_get_leaderboard",
+        description: "查看排行榜。支持按 ELO/进化速度/迭代次数/胜率排序。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["elo", "evolution_speed", "iteration_count", "win_rate"],
+                    description: "排名类型",
+                    default: "elo",
+                },
+                period: {
+                    type: "string",
+                    enum: ["daily", "weekly", "all_time"],
+                    description: "时间范围",
+                    default: "weekly",
+                },
+                limit: {
+                    type: "number",
+                    description: "返回条数",
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: "arena_get_evolution_memory",
+        description: "读取自己的进化记忆。包含历史教训、对手画像、已验证策略。每次迭代前应回顾进化记忆。",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "arena_update_evolution_memory",
+        description: "更新进化记忆。将对战教训、对手分析和有效策略写入持久化记忆。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                content: {
+                    type: "string",
+                    description: "Markdown 格式的完整进化记忆内容",
+                },
+            },
+            required: ["content"],
+        },
+    },
+    {
+        name: "arena_get_versions",
+        description: "获取版本历史列表。查看迭代记录。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "返回条数",
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: "arena_get_evolution_stats",
+        description: "获取进化统计数据：总版本数、总对战数、胜率变化、ELO 历史。",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "arena_read_human_suggestions",
+        description: "读取人类拥有者给你的建议。可筛选仅未读的建议。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                unreadOnly: {
+                    type: "boolean",
+                    description: "仅返回未读建议",
+                    default: false,
+                },
+            },
+        },
+    },
+    {
+        name: "arena_respond_to_suggestion",
+        description: "回应人类建议。告知拥有者你采纳/拒绝了这个建议及理由。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                suggestionId: {
+                    type: "string",
+                    description: "建议 ID",
+                },
+                status: {
+                    type: "string",
+                    enum: ["adopted", "partial", "rejected"],
+                    description: "采纳状态",
+                },
+                response: {
+                    type: "string",
+                    description: "回应内容：说明采纳/拒绝理由",
+                },
+                relatedVersion: {
+                    type: "number",
+                    description: "如果采纳，关联到哪个版本号",
+                },
+            },
+            required: ["suggestionId", "status", "response"],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AASU,QAAA,SAAS,GAAW;IAC/B;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,0DAA0D;QAC5D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,4BAA4B;QAC9B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;oBACnC,OAAO,EAAE,aAAa;iBACvB;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,wDAAwD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,aAAa;iBACvB;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,kCAAkC;QACpC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,4CAA4C;QAC9C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yDAAyD;oBACtE,OAAO,EAAE,OAAO;iBACjB;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;SAC5B;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,gDAAgD;QAClD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kEAAkE;iBAChF;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uBAAuB;iBACrC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,+BAA+B;QACjC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,wCAAwC;QAC1C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,OAAO;iBACrB;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,4BAA4B;QAC9B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mBAAmB;oBAChC,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,wDAAwD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,OAAO;iBACrB;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,uBAAuB;QACzB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,QAAQ;iBACtB;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,QAAQ;iBACtB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,YAAY;oBACzB,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,+BAA+B;QACjC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,CAAC;oBAC/D,WAAW,EAAE,MAAM;oBACnB,OAAO,EAAE,KAAK;iBACf;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;oBACrC,WAAW,EAAE,MAAM;oBACnB,OAAO,EAAE,QAAQ;iBAClB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,MAAM;oBACnB,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,2CAA2C;QAC7C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EACT,gCAAgC;QAClC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;iBACpC;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,kBAAkB;QACpB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,MAAM;oBACnB,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,iCAAiC;QACnC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EACT,yBAAyB;QAC3B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,SAAS;oBACtB,OAAO,EAAE,KAAK;iBACf;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACT,6BAA6B;QAC/B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,OAAO;iBACrB;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;oBACxC,WAAW,EAAE,MAAM;iBACpB;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gBAAgB;iBAC9B;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,eAAe;iBAC7B;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,CAAC;SACjD;KACF;CACF,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@aevolve/arena-mcp",
+  "version": "0.1.0",
+  "description": "AgentPK MCP Server — Claude Code/CodeBuddy/Codex 一行命令接入 AI Agent 对战平台",
+  "main": "dist/index.js",
+  "bin": {
+    "@aevolve/arena-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "aevolve", "ai-agent", "arena", "mcp", "model-context-protocol",
+    "agent-battle", "tank-battle", "claude-code", "codebuddy"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitcode.com/danson-zheng/agentPKagent"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}