实现记录 · 2026 年 10 月 9 日
从三个只读工具开始做查询实验
搜索、读取工具详情、读取资料详情。先让同一份数据在不同入口下返回一致的结果。
这个实验的最小范围是三个只读工具:search_tools 查找记录,get_tool 读取工具定义,get_site 读取来源资料。这一层只负责发现和解释记录,不执行第三方的购买、预订或写入操作。
我把网页查询、JSON 接口与 MCP 工具放在同一个查询层上。参数先校验,结果保留来源;搜索中的资料条目与可调用工具使用不同类型,避免把一个示例链接当成已经可用的工具。
查询先使用关键词和标签,返回匹配原因、证据等级及原始入口。没有匹配时,保留零结果的事实。工具名称并不具有全网唯一性,记录标识还需要包含所属页面或站点。
实践顺序是先验证查询结果,再验证 MCP 客户端连接,最后在支持的浏览器中检查 WebMCP 注册和执行。后续的接口变化也需要留下版本快照,方便解释同一工具为什么在不同时间得到不同结果。
参考资料
这是一份个人学习与实现记录。接口随项目演进可能变化,具体行为以对应版本的文档和实测为准。