korean-law-mcp系统架构深度解析99个内部工具如何压缩成10个曝光工具AI上下文成本直降52%【免费下载链接】korean-law-mcp법제처 국가법령정보를 LLM에서 바로 조회하는 MCP 서버. 법령·판례·조례 검색과 인용 검증 | MCP server for Korean law — search statutes, precedents, and ordinances, and verify citations项目地址: https://gitcode.com/gh_mirrors/ko/korean-law-mcpkorean-law-mcp 是一个韩国法律 MCP 服务器它把韩国法制处国家法令信息的法令、判例、条例、行政规则等官方数据接口包装成 AI 助手可直接调用的工具。这个项目内部其实有99 个工具但每次只向 AI 客户端曝光其中10 个——这一设计让 AI 每次会话加载的工具列表上下文成本直降 52%约 6,000 → 约 2,900 个 token。今天这篇文章就用大白话拆解为什么 AI 工具少即是多99 到 10 是怎么压缩的没曝光的功能又去哪里了一、先搞清楚为什么工具数量会影响AI成本很多新手不知道MCP 服务器接入 AI如 Claude、ChatGPT时客户端会先调用一次ListTools把所有工具的名称 描述 参数结构读进 AI 的上下文窗口。这意味着工具越多、描述越长 → 每次会话固定消耗的 token 越多钱也越多AI 要在一堆工具里挑工具候选越多选错的概率越高korean-law-mcp 覆盖法令、判例、解释例、关税、条约、学校规则……官方 API 就有 42 个端点最初曝光的工具一度有 19 个工具列表上下文高达约15.1KB。开发者在 v4.4.0 做了一个关键架构决策曝光 10 个隐藏 89 个。二、核心架构三层漏斗设计整个压缩逻辑可以用一个漏斗来理解详见官方架构文档 docs/ARCHITECTURE.md99 个内部工具allTools[] 全部注册 │ 按 V3_EXPOSED 名单过滤 ▼ 10 个曝光工具ListTools 只看到这些 │ 未命中走两跳通道 ▼ discover_tools按意图找工具→ execute_tool代理执行第 1 层注册中心——99 个工具全都要所有工具统一注册在 src/tool-registry.ts 的allTools[]数组里每个工具包含名称、描述、Zod 参数校验模式和执行函数。注意隐藏 ≠ 删除89 个隐身工具依然完整可用。第 2 层曝光名单——一个 Set 决定一切到底曝光谁答案只有一个地方src/lib/tool-profiles.ts 里的V3_EXPOSED名单。注册中心在生成工具列表时执行一行过滤src/tool-registry.tstools/list响应只返回这 10 个工具其余 89 个的描述一个字都不会发给 AI名单集中维护在单一源文件避免过滤逻辑和引导文案两处各持一份名单导致不一致第 3 层两跳通道——没曝光的功能随时找得到这是架构里最巧妙的一环。如果用户问帮我查一下关税解释例一个没曝光的工具能力AI 不会干等而是走 src/tools/meta-tools.ts 提供的两个元工具discover_tools传入自然语言意图如关税它在 src/lib/tool-discovery.ts 中按别名精确匹配 分类名 描述模糊匹配分级检索还内置了税务审议院韩国反垄断委员会等实务叫法的别名表execute_tool拿到工具名后代为执行参数照样走 Zod 严格校验匹配结果还被刻意限制为最多 5 个分类实测把一次响应的平均大小压低了 67%超出部分会明确告知另有 N 个分类被省略绝不静默截断。三、曝光的 10 个工具都是谁怎么选出来的工具定位压缩了什么legal_research多步骤法务研究总入口吞并 8 个chain_*链式工具用task参数区分legal_analysis精密分析总入口吞并 4 个杀手级功能引用验证/判例存废/行为时法/影响图谱用mode参数区分search_law/get_law_text法令搜索 / 条文全文最常用的高频查询get_annexes别表附表查询曾因走两跳浪费 15 秒而被提名为曝光search_decisions/get_decision_text18 个裁决领域统一检索/全文判例、宪法法院、税务审议院……一次覆盖ordinance_radar条例整理雷达地方公务员追踪上位法改动的刚需discover_tools/execute_tool两跳通道的入口与执行器89 个隐身工具的总通道曝光标准写在代码注释里src/lib/tool-profiles.ts总结起来就三条高频直达的、链式工具经常回退调用的终点、走两跳平均要多花 5 秒以上的——才配占一个曝光名额。其中legal_research的 8 种任务模式全面研究、法体系、执法依据、抗辩准备、修法追踪、条例比较、程序细则、文档审阅直接内联在 src/tools/legal-research.ts 中连用户把scenario值误填到task参数这种 AI 常见手误都会被自动纠正。四、52% 是怎么省下来的v4.4.0 的实测量化数据CHANGELOG.md工具列表上下文约 15.1KB → 约 7.2KB≈6,000 → ≈2,900 token52% 削减8 个chain_*工具 → 1 个legal_researchtask 参数4 个分析工具 → 1 个legal_analysismode 参数而且这个压缩是无损的旧工具名全部保留在allTools里老客户端直接按旧名调用照常工作向下兼容execute_tool通道让新客户端也能按旧名触达 89 个隐身工具连tools/list的响应都在首次请求时构建好缓存复用stateless HTTP 模式下不再每次重复转换 Zod → JSON Schema配合其他优化——判例响应压缩再省 74% token、批量条文一次 API 调用、LRU 缓存命中率约 82%——整套省 token的组合拳才成立。五、这套设计对写 MCP 服务器的人有什么启发工具列表是常驻税每多一个工具描述每个会话都要为此付费暴露要克制用参数代替工具同质工具合并为一个入口 task/mode枚举是压缩上下文最直接的杠杆隐藏不等于移除保留全量注册 发现/代理两跳通道功能一个不少单一事实源曝光名单、别名表、分类表都集中维护避免多份拷贝各自过期截断必须出声匹配结果超限时要告诉调用方还有 N 条没显示静默截断等于制造幻觉六、相关源码与文档导航想了解看这里整体架构图与执行预算docs/ARCHITECTURE.md99 个工具注册与输出门禁src/tool-registry.ts曝光名单与工具分类别名src/lib/tool-profiles.ts两跳发现/执行机制src/tools/meta-tools.ts意图匹配与分级检索src/lib/tool-discovery.ts8 合 1 的链式研究入口src/tools/legal-research.ts52% 削减的完整变更说明CHANGELOG.md一句话总结korean-law-mcp 的精髓不是多而是该藏的 89 个工具一个不少、该省的每 1 个 token 都不浪费——这正是它敢把法制处 42 个官方 API 全部收进 10 个曝光工具背后又敢于承诺 52% 上下文削减的底气。【免费下载链接】korean-law-mcp법제처 국가법령정보를 LLM에서 바로 조회하는 MCP 서버. 법령·판례·조례 검색과 인용 검증 | MCP server for Korean law — search statutes, precedents, and ordinances, and verify citations项目地址: https://gitcode.com/gh_mirrors/ko/korean-law-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考