立项背景:AI Agent(如Cline、Claude Desktop)需要解析HTML、抓取网页,但现有方案依赖重量级浏览器或复杂Python环境,部署成本高、依赖多。目标:打造轻量、免环境依赖的HTML解析MCP服务器,让任何Agent通过MCP协议一键接入。功能模块:四个核心工具——kage_parse_html解析HTML片段提取结构化数据;kage_fetch_url抓取URL并抽取内容;kage_render将HTML渲染为终端风格截图;kage_execute_js在DOM上下文执行JavaScript。业务流程:Agent通过MCP客户端配置调用kage服务器,传入HTML或URL,服务器以JSON-RPC返回结构化结果,全程无需Python、Node.js或浏览器运行时。
整体架构:基于MCP(JSON-RPC)协议的轻量服务器,采用PyInstaller将Python运行时、解析引擎与Node.js打包为单个92MB可执行文件,实现零依赖交付。负责模块与结果:独立完成服务器核心、四个工具API、打包分发全流程;封装JSON-RPC 2.0协议,实现HTML结构化解析、URL抓取、终端渲染、JS执行四类能力,提供pip安装与GitHub Releases两种分发方式。难点与解决:一是打破跨语言依赖,将Node.js一并打包进单文件,用户无需安装任何运行时;二是严格按MCP规范实现tools/list与tools/call,保证与Cline、Claude Desktop等主流客户端无缝对接;三是分发兼容,同时支持PyInstaller产物与pip包两种安装路径。