#!/usr/bin/env python3
"""最小可验证 MCP Server（零外部依赖，纯标准库实现 JSON-RPC 2.0 over stdio）。

实现 MCP 协议最小子集：initialize / tools/list / tools/call，
声明 tools 能力，可被任意标准 MCP client（Claude Desktop、Cursor 等）识别。

贴合 JD2 场景（百度 游戏 Agent 产品经理）：提供两个面向「泛游戏 Agent」的工具：
- list_game_agent_scopes：返回支持的游戏 Agent 场景（资讯/问答/陪伴/任务执行）
- plan_game_task：给定 游戏 + 任务，返回 Agent 拆解的子任务步骤（演示 Planning + Tool Use 概念）

设计原则与 genai-rag-lab 一致：默认路径零外部依赖、沙箱可跑、可验证。
"""
from __future__ import annotations

import json
import sys

SERVER_NAME = "game-agent-mcp"
SERVER_VERSION = "0.1.0"
PROTOCOL_VERSION = "2024-11-05"

# --------------------------------------------------------------------------
# 工具实现（贴合泛游戏 Agent 场景，演示对 Agent 机制的理解：Planning / Tool Use）
# --------------------------------------------------------------------------
GAME_SCENES = [
    {"scene": "game_news", "name": "游戏资讯", "desc": "聚合与推送新游评测、版本更新、活动资讯"},
    {"scene": "qa", "name": "智能问答", "desc": "基于游戏知识库的攻略与机制问答"},
    {"scene": "companion", "name": "桌面陪伴", "desc": "常驻桌面的轻互动陪伴角色"},
    {"scene": "task_exec", "name": "任务执行", "desc": "代玩家执行查价、组队、日常等可执行任务"},
]


def list_game_agent_scopes() -> str:
    lines = [f"- {s['scene']}（{s['name']}）：{s['desc']}" for s in GAME_SCENES]
    return "支持的泛游戏 Agent 场景：\n" + "\n".join(lines)


def plan_game_task(game: str, task: str) -> str:
    steps = [
        f"1. 意图澄清：明确在《{game}》中「{task}」的目标与完成判定",
        "2. 上下文检索：拉取游戏知识库 / 存档，确认前置条件与约束",
        "3. 子任务拆解：将目标拆成可顺序执行的原子步骤",
        "4. Tool Use：调用外部工具（查价 / 地图 / 组队 API）执行原子步骤",
        "5. 校验与回滚：每步结果校验，失败触发降级或人工确认",
    ]
    return f"为《{game}》的「{task}」生成的 Agent 执行计划：\n" + "\n".join(steps)


# --------------------------------------------------------------------------
# 工具注册表（符合 MCP tools/list 的 schema 约定）
# --------------------------------------------------------------------------
TOOLS = [
    {
        "name": "list_game_agent_scopes",
        "description": "列出本 MCP Server 支持的泛游戏 Agent 场景（游戏资讯/智能问答/桌面陪伴/任务执行），无参数。用于让 Agent 在初始化时了解可用能力边界。",
        "inputSchema": {"type": "object", "properties": {}},
    },
    {
        "name": "plan_game_task",
        "description": "给定游戏名与任务，返回由 Agent 拆解的可执行子任务步骤（演示 Planning + Tool Use 概念）。",
        "inputSchema": {
            "type": "object",
            "properties": {
                "game": {"type": "string", "description": "游戏名称，如《原神》"},
                "task": {"type": "string", "description": "玩家希望完成的任务，如「查当前版本最强角色」"},
            },
            "required": ["game", "task"],
        },
    },
]

DISPATCH = {
    "list_game_agent_scopes": lambda args: list_game_agent_scopes(),
    "plan_game_task": lambda args: plan_game_task(args.get("game", ""), args.get("task", "")),
}


# --------------------------------------------------------------------------
# 协议分发
# --------------------------------------------------------------------------
def handle_request(req: dict) -> dict | None:
    """返回响应对象；返回 None 表示对通知无需回包。"""
    method = req.get("method")
    req_id = req.get("id")

    # 通知（无 id）：initialized / ping 等，无需回包
    if method in ("notifications/initialized", "ping"):
        return None

    if method == "initialize":
        return {
            "jsonrpc": "2.0",
            "id": req_id,
            "result": {
                "protocolVersion": PROTOCOL_VERSION,
                "capabilities": {"tools": {}},
                "serverInfo": {"name": SERVER_NAME, "version": SERVER_VERSION},
            },
        }

    if method == "tools/list":
        return {"jsonrpc": "2.0", "id": req_id, "result": {"tools": TOOLS}}

    if method == "tools/call":
        name = req.get("params", {}).get("name")
        args = req.get("params", {}).get("arguments", {}) or {}
        try:
            text = DISPATCH[name](args)
            return {
                "jsonrpc": "2.0",
                "id": req_id,
                "result": {"content": [{"type": "text", "text": text}], "isError": False},
            }
        except Exception as e:  # 工具层异常 → 以 isError 形式回包，不中断 server
            return {
                "jsonrpc": "2.0",
                "id": req_id,
                "result": {"content": [{"type": "text", "text": f"工具执行出错：{e}"}], "isError": True},
            }

    # 未知方法
    if req_id is not None:
        return {"jsonrpc": "2.0", "id": req_id, "error": {"code": -32601, "message": f"method not found: {method}"}}
    return None


def main() -> None:
    for line in sys.stdin:
        line = line.strip()
        if not line:
            continue
        try:
            req = json.loads(line)
        except json.JSONDecodeError:
            continue
        try:
            resp = handle_request(req)
        except Exception:
            resp = None
        if resp is not None:
            sys.stdout.write(json.dumps(resp, ensure_ascii=False) + "\n")
            sys.stdout.flush()


if __name__ == "__main__":
    main()
