Lexlink Ko MCP

LexLink - Korean National Law Information MCP Server

🌐 用其他语言阅读： 英语 | 韩语（Korean）

 ](https://smithery.ai/server/@rabqatab/lexlink-ko-mcp)  

LexLink是一个MCP（模型上下文协议）服务器，用于公开韩国国家法律信息API(open.law.go.kr)AI代理和LLM应用程序。它使人工智能系统能够通过标准化的MCP工具搜索、检索和分析韩国法律信息。

特性

• 54个MCP工具+2个MCP资源 获取全面的韩国法律信息

- 搜索和检索韩国法律（生效日期和公告日期） - 搜索和检索英文翻译的法律 - 搜索和检索管理规则 - 查询特定文章、段落和子项 - Law-ordinance linkage（法令-自治法规关联） - Delegated law information（委任法） - 第三阶段-判例法与法律研究 - 法院precedents（判例） - 宪法法院判决（Constitutional Court Decisions） - Legal interpretations（法令解释例） - 行政上诉决定（行政审判例） - 第4阶段-文章引文提取 - 从任何法律文章中提取法律引文（100%准确） - 新：第5阶段-人工智能搜索 - 自然语言查询的语义搜索（aiSearch） - 相关法律发现（aiRltLs_search） - MCP资源-法律ID缓存 - 缓存约20个常用法律名称到稳定名称的映射법령ID代码 - 按韩文名称或缩写查找模板(lexlink://law/{name}) - 动态缓存：搜索结果自动填充缓存

• 智能功能 （灵感来自 韩国法律mcp):

- 智能高速缓存 -按工具TTL缓存（搜索1小时，文章24小时，AI搜索30分钟） - 法律名称决议 -Auto-resolves Korean abbreviations（自通法→资本市场和金融投资业相关法律），52 seed aliases+dynamic learning - 链条工具 -一次通话中的多步骤研究工作流程（第9阶段）

• 100%语义验证 -所有第1-5阶段工具均已确认返回真实法律数据
• 错误处理 -带有解决提示的可操作错误消息
• 韩语文本支持 -韩语字符的正确UTF-8编码
• 响应格式 -JSON（默认）、HTML或XML（支持多种格式）

项目状态

🎉 生产准备就绪-第9阶段完成！

最新的： v2.1.0--54个工具（增加了第9阶段），智能缓存(cache.py)，法律名称解析(resolver.py)，用于多步骤研究工作流程的链式工具。

先决条件

• Python 3.10+
• law.go.kr OC标识符：注册地址 open.law.go.kr

快速开始

1.安装依赖项

uv sync

2.配置OC标识符

选项A：环境变量（推荐）

# Set OC in your environment
export OC=your_id_here

选项B：传入工具参数

# Override OC in each tool call
eflaw_search(query="법령명", oc="your_id")

3.运行服务器

# Stdio transport (for Claude Code, Cursor, etc.)
OC=your_oc uv run stdio

# HTTP transport (for Kakao PlayMCP)
OC=your_oc TRANSPORT=http uv run serve

可用工具

第一阶段：核心法律API（6个工具）

1. eflaw_search -按生效日期搜索法律

Search for laws organized by effective date（执行日期）。

eflaw_search(
    query="자동차관리법",      # Search keyword
    display=10,                # Results per page
    type="XML",                # Response format
    ef_yd="20240101~20241231"  # Optional date range
)

2. law_search -按公告日期搜索法律

Search for laws organized by announcement date（以公布日期为准）。

law_search(
    query="민법",
    display=10,
    type="XML"
)

3. eflaw_service -检索法律内容（生效日期）

在生效日期前获取完整的法律文本和文章。

重要： For specific article queries（e.g.，“第174条”），use the jo 参数。一些法律有400多篇文章，回应可能超过1MB jo.

# Get specific article (RECOMMENDED)
eflaw_service(
    mst="279823",              # Law MST
    jo="017400",               # Article 174 (제174조)
    type="XML"
)

# Get full law (WARNING: large response)
eflaw_service(
    id="001823",
    type="XML"
)

4. law_service -检索法律内容（公告日期）

在公告日期前获取完整的法律文本和文章。

重要： For specific article queries（e.g.，“第174条”），use the jo 参数。一些法律有400多篇文章，回应可能超过1MB jo.

# Get specific article (RECOMMENDED)
law_service(
    mst="279823",              # Law MST
    jo="017400",               # Article 174 (제174조)
    type="XML"
)

5. eflaw_josub -查询文章/段落（生效日期）

查询特定文章的最佳工具。 仅返回所请求的文章/段落。

eflaw_josub(
    mst="279823",              # Law MST
    jo="017400",               # Article 174 (제174조)
    type="XML"
)
# jo format: "XXXXXX" where first 4 digits = article (zero-padded), last 2 = branch (00=main)
# Examples: "017400" (제174조), "000300" (제3조), "001502" (제15조의2)

6. law_josub -查询文章/段落（公告日期）

查询特定文章的最佳工具。 仅返回所请求的文章/段落。

law_josub(
    mst="279823",              # Law MST
    jo="017200",               # Article 172 (제172조)
    type="XML"
)

第二阶段：扩展API（9个工具）

7. elaw_search -搜索英文翻译法律

搜索翻译成英文的韩国法律。

elaw_search(
    query="employment",
    display=10,
    type="XML"
)

8. elaw_service -检索英语法律内容

获取完整的英文翻译法律文本。

elaw_service(
    id="009589",
    type="XML"
)

9. admrul_search -搜索管理规则

Search administrative rules（训令、例规、告示、公告、指南）。

admrul_search(
    query="학교",
    display=10,
    type="XML"
)

10. admrul_service -检索管理规则内容

获取完整的管理规则文本及其附件。

admrul_service(
    id="62505",
    type="XML"
)

11. lnkLs_search -搜索法律条例链接

查找与当地法规相关的法律。

lnkLs_search(
    query="건축",
    display=10,
    type="XML"
)

12. lnkLsOrdJo_search -搜查条例条文附例

查找与特定法律条款相关的条例条款。

lnkLsOrdJo_search(
    knd="002118",              # Law ID
    display=10,
    type="XML"
)

13. lnkDep_search -按部委搜索法律条例链接

查找与政府部门条例相关的法律。

lnkDep_search(
    org="1400000",             # Ministry code
    display=10,
    type="XML"
)

14. drlaw_search -检索法律与条例的关联统计数据

获取链接统计表（HTML格式）。

drlaw_search(
    lid="001823",              # Law ID
    type="HTML"
)

15. lsDelegated_service -检索委托法律信息

获取有关授权法律、规则和条例的信息。

lsDelegated_service(
    id="001823",
    type="XML"
)

第三阶段：判例法和法律研究（8个工具-新！）

提示： 全部 *_service 第3阶段的工具支持 sections="summary" 参数仅返回简短摘要，而不是完整的文档文本。

16. prec_search -搜索法庭判例

搜索韩国最高法院和下级法院的判例。

prec_search(
    query="담보권",
    display=10,
    type="XML",
    curt="대법원"             # Optional: Court name filter
)

17. prec_service -检索法院判例全文

获取包含案件详细信息的完整法庭判例文本。

prec_service(
    id="228541",
    type="XML"
)

18. detc_search -搜索宪法法院判决

搜索韩国宪法法院的判决。

detc_search(
    query="벌금",
    display=10,
    type="XML"
)

19. detc_service -检索宪法法院判决全文

获取完整的宪法法院判决文本。

detc_service(
    id="58386",
    type="XML"
)

20. expc_search -搜索法律解释

搜索政府机构发布的法律解释先例。

expc_search(
    query="임차",
    display=10,
    type="XML"
)

21. expc_service -检索法律解释全文

获取完整的法律解释文本。

expc_service(
    id="334617",
    type="XML"
)

22. decc_search -搜索行政上诉决定

搜索韩国行政上诉决定。

decc_search(
    query="*",                # Search all decisions
    display=10,
    type="XML"
)

23. decc_service -检索行政上诉决定全文

获取完整的行政上诉决定文本。

decc_service(
    id="243263",
    type="XML"
)

第4阶段：文章引文提取（1个工具-新！）

24. article_citation -法律文章摘录

提取特定法律文章引用的所有法律引文。

# First, search for the law to get MST
eflaw_search(query="건축법")  # Returns MST: 268611

# Then extract citations
article_citation(
    mst="268611",              # Law MST from search result
    law_name="건축법",          # Law name
    article=3                  # Article number (제3조)
)

答复：

{
    "success": true,
    "law_name": "건축법",
    "article": "제3조",
    "citation_count": 12,
    "internal_count": 4,
    "external_count": 8,
    "citations": [
        {
            "type": "external",
            "target_law_name": "「국토의 계획 및 이용에 관한 법률」",
            "target_article": 56,
            "target_paragraph": 1
        }
    ]
}

主要特点：

• 通过HTML解析（非基于LLM）实现100%准确率
• API成本为零（无外部LLM调用）
• 平均提取时间~350ms
• 区分内部引用和外部引用

第5阶段：人工智能搜索（2个工具-新！）

25. aiSearch -基于人工智能的语义规律搜索

⭐ 模糊或自然语言查询的首选工具。 当用户的意图不清楚或对话时，请先使用此选项。

使用智能/语义搜索来查找具有全文的相关法律文章。

aiSearch(
    query="뺑소니 처벌",           # Natural language query
    search=0,                      # 0: law articles, 1: appendix, 2: admin rules, 3: admin appendix
    display=20,                    # Results per page
    page=1,                        # Page number
    type="JSON"                    # Response format (JSON default)
)

最适合： Natural language queries like“酒后驾驶罚款”、“离婚财产分割”、“继承问题”

26. aiRltLs_search -人工智能驱动的相关法律搜索

⭐ 从模糊主题中发现相关法律的首选工具。 当用户想要探索围绕一般主题的法律时，请使用此功能。

查找与给定法律名称或关键字语义相关的法律。

aiRltLs_search(
    query="민법",                  # Law name or keyword
    search=0,                      # 0: law articles, 1: admin rule articles
    type="JSON"                    # Response format (JSON default)
)

最适合： Finding related laws like《民法》→商法、医疗法、诉讼促进法

第7阶段：扩展法律信息（18种工具）

第9阶段：链式工具（5个工具）

灵感源自 韩国法律mcp，这些工具在一次调用中运行多步研究工作流，从而消除了LLM手动编排连续工具调用的需要。

工具选择指南

在搜索韩国法律时，请根据查询清晰度选择工具：

配置

环境变量

OC优先级

解析OC标识符时：

1. 工具参数 （最高优先级）- oc 工具调用中的参数
2. 环境变量 - OC env-var（通过.env或HTTP头中间件设置）

用法示例

示例1：基本搜索

# Search for automobile management law
result = eflaw_search(
    query="자동차관리법",
    display=5,
    type="XML"
)

# Returns:
{
    "status": "ok",
    "request_id": "uuid",
    "upstream_type": "XML",
    "data": {
        # Law search results...
    }
}

示例2：使用日期范围搜索

# Find laws effective in 2024
result = eflaw_search(
    query="교통",
    ef_yd="20240101~20241231",
    type="XML"
)

示例3：错误处理

# Missing OC parameter
result = eflaw_search(query="test")

# Returns helpful error:
{
    "status": "error",
    "error_code": "MISSING_OC",
    "message": "OC parameter is required but not provided.",
    "hints": [
        "1. Tool argument: oc='your_value'",
        "2. Environment variable: OC=your_value"
    ]
}

黄金MCP刀具轨迹

这些示例展示了真实世界的对话流程，展示了法学硕士如何与LexLink工具交互以回答法律研究问题。

轨迹1：基本法研究

用户查询： 《民法典》第20条是什么

工具调用：

1. law_search(query="민법", display=50, type="XML") → 查找民法典ID
2. law_service(id="000021", jo="002000", type="XML") → 检索第20条文本

结果： 法学硕士提供《民法典》第20条的格式解释，包括完整的法律文本和上下文。

______________________________________________________________________

轨迹2：法庭先例分析

用户查询： “查找最高法院最近关于担保权益的判例”

工具调用：

1. prec_search(query="담보권", curt="대법원", display=50, type="XML") → 搜索最高法院判例
2. prec_service(id="228541", type="XML") → 检索顶级先例详细信息

结果： LLM总结了与担保权益相关的案件编号、日期和持有情况等关键先例。

______________________________________________________________________

轨迹3：跨阶段法律研究

用户查询： “《劳动标准法》是如何处理加班的，有相关的法院先例吗？”

工具调用：

1. eflaw_search(query="근로기준법", display=50, type="XML") → 《劳动标准法》
2. eflaw_service(id="001234", jo="005000", type="XML") → 检索第50条（加班规定）
3. prec_search(query="근로기준법 연장근로", display=30, type="XML") → 搜索加班先例
4. prec_service(id="234567", type="XML") → 检索领先先例

结果： 法学硕士将法定文本与司法解释相结合，提供全面的分析，展示法院如何适用加班规定。

______________________________________________________________________

轨迹4：宪法审查

用户查询： “宪法法院是否审查了有关罚款的法律？”

工具调用：

1. detc_search(query="벌금", display=50, type="XML") → 搜索宪法法院的判决
2. detc_service(id="58386", type="XML") → 检索决策全文
3. law_search(query=, type="XML") → 根据上下文查找相关法律

结果： 法学硕士解释了宪法法院对罚款相关条款的判决及其对具体法律的影响。

______________________________________________________________________

轨迹5：行政法研究

用户查询： “学校有什么行政规定，有相关的法律解释吗？”

工具调用：

1. admrul_search(query="학교", display=50, type="XML") → 搜索学校相关管理规定
2. admrul_service(id="62505", type="XML") → 检索规则内容
3. expc_search(query="학교", display=30, type="XML") → 搜索法律解释
4. expc_service(id="334617", type="XML") → 检索解释详细信息

结果： 法学硕士课程为学校提供了行政框架的概述，并附有官方机构的解释。

______________________________________________________________________

轨迹6：综合法律分析

用户查询： “我正在研究租赁住房纠纷。给我看看相关的法律、法院判例和行政上诉决定。”

工具调用：

1. eflaw_search(query="주택임대차보호법", display=50, type="XML") → 《住房租赁保护法》
2. eflaw_service(id="002876", type="XML") → 检索完整的法律文本
3. prec_search(query="주택임대차", display=50, type="XML") → 搜索房屋租赁先例
4. prec_service(id="156789", type="XML") → 检索关键先例
5. decc_search(query="주택임대차", display=30, type="XML") → 搜索行政上诉决定
6. decc_service(id="243263", type="XML") → 检索上诉决定

结果： 法学硕士提供全面的法律研究报告，涵盖租赁住房纠纷的法律框架、司法解释和行政判例。

______________________________________________________________________

轨迹7：引文网络分析（第4阶段）

用户查询： “《建筑法》第3条引用了哪些法律？”

工具调用：

1. eflaw_search(query="건축법", display=50, type="XML") → 查找建筑法案，获取MST
2. article_citation(mst="268611", law_name="건축법", article=3) → 提取所有引文

结果： LLM提供完整的引文分析，显示12篇引文（8篇外部法律，4篇内部参考文献），包括具体的文章和段落参考。

______________________________________________________________________

轨迹8：人工智能驱动的自然语言搜索（第5阶段）

用户查询： “肇事逃逸事故的处罚是什么？”

工具调用：

1. aiSearch(query="뺑소니 처벌", search=0, display=20, type="XML") → 对肇事逃逸处罚的语义搜索

结果： LLM receives full article text from相关laws（特定犯罪加重处罚等相关法律第5条之3）with complete条款about hit-and-run penalties，enabling completive answeet without needing to know special law names。

______________________________________________________________________

轨迹9：发现相关规律（第五阶段）

用户查询： “哪些法律与民法典有关？”

工具调用：

1. aiRltLs_search(query="민법", search=0, type="XML") → 查找语义相关的定律

结果： 法学硕士发现相关法律，如상법 （商业法案），의료법 （《医疗服务法》），소송촉진법 （《诉讼催告特别案件法》），显示了跨法律领域的联系。

______________________________________________________________________

关键模式

1. 用于模糊查询的AI工具：使用 aiSearch 或 aiRltLs_search 当用户意图不明确或对话时
2. 先搜索，然后检索：在调用服务工具之前，始终搜索以查找ID
3. 使用display=50-100进行法律搜索：确保根据相关性排名找到精确匹配
4. 组合阶段：混合第1阶段（法律）、第2阶段（行政规则）、第3阶段（先例）和第5阶段（人工智能搜索）进行完整研究
5. 类型参数：默认值为 type="JSON"；指定 type="XML" 如果您的管道需要XML
6. 文章编号：查询特定文章时使用6位数字格式（例如，第20条为“002000”）

发展

项目结构

lexlink-ko-mcp/
├── src/lexlink/
│   ├── server.py        # Main MCP server with 54 tools
│   ├── _helpers.py      # Shared helpers: run_search, run_service, TOOL_ANNOTATIONS
│   ├── cache.py         # Intelligent per-tool TTL caching (~183 lines)
│   ├── resolver.py      # Korean law name/abbreviation resolution (~225 lines)
│   ├── http_server.py   # HTTP/SSE server for Kakao PlayMCP
│   ├── stdio_server.py  # Stdio transport entry point
│   ├── params.py        # Parameter resolution & mapping
│   ├── validation.py    # Input validation
│   ├── parser.py        # XML parsing utilities
│   ├── ranking.py       # Relevance ranking
│   ├── citation.py      # Article citation extraction (Phase 4)
│   ├── client.py        # HTTP client for law.go.kr API
│   ├── errors.py        # Error codes & responses
│   ├── raw_logger.py    # PlayMCP traffic logging
│   └── log_processor.py # Log format converter
├── logs/playmcp/         # PlayMCP traffic logs (daily JSONL)
├── pyproject.toml        # Project configuration
└── README.md             # This file

运行测试

# Install test dependencies
uv sync

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=src/lexlink --cov-report=html

# Run specific test category
uv run pytest -m unit
uv run pytest -m integration
uv run pytest -m e2e

添加新工具

当前状态： 实施54/54工具（第1-9阶段完成）。第1-5阶段工具已验证。

要从剩余的124多个API中实现其他工具：

1. 遵循中确立的模式 src/lexlink/server.py
2. 使用 ctx: Context = None MCP记录/进度参数
3. 使用通用解析器函数(extract_items_list, update_items_list)
4. 添加语义验证测试

工具实施模式：

• 每个工具都是一个带有MCP模式的装饰函数
• 用途 ctx: Context = None MCP上下文参数
• 2层OC分辨率：工具arg>env-var
• 通用解析器函数适用于任何XML标记
• 具有可操作提示的全面错误处理

部署

部署到Kakao PlayMCP（HTTP服务器）

LexLink也可以部署为Kakao PlayMCP等平台的HTTP服务器。

重要提示： Kakao PlayMCP不接受URL中的端口号。 您必须使用Nginx作为反向代理才能在端口80上提供服务。

快速入门（本地测试）：

# Run the HTTP server
OC=your_oc uv run serve

# Server starts at: http://localhost:8000/sse

生产设置：

Internet → Nginx (port 80) → LexLink (port 8000)

PlayMCP注册：

有关详细的部署说明（AWS EC2、Nginx、systemd、HTTPS），请参阅 docs/DEPLOYMENT_GUIDE.md.

PlayMCP流量记录

LexLink内置了用于PlayMCP流量分析的日志记录功能。日志以仪表板兼容的JSONL格式保存。

日志位置： logs/playmcp/YYYY-MM-DD.jsonl

日志架构：

{
  "rpc_id": "3",
  "request_id": "d8ee45eb",
  "session_id": "9ff9dc23431848a4901b4cb6326ba5bd",
  "timestamp": "2025-12-25T05:40:23.957987",
  "duration_ms": 1.52,
  "method": "tools/call",
  "tool_name": "aiSearch",
  "params": { "arguments": {"query": "뺑소니 처벌"} },
  "client": "PlayMCP",
  "client_version": "2025.0.0",
  "protocol_version": "2025-06-18",
  "client_ip": "220.64.111.219",
  "oc": "user_id",
  "status": "success",
  "status_code": 200,
  "result": { ... }
}

特征：

• 每日日志轮换（每天一个文件）
• 用于过滤和分析的仪表板兼容格式
• 通过计时捕获请求/响应对
• SSE流响应解析

转换旧原始日志：

uv run python -m lexlink.log_processor input.jsonl output.jsonl

故障排除

“OC参数是必需的”错误

解决方案： 使用上述三种方法之一设置OC标识符。

韩文字符显示不正确

解决方案： 确保您的终端支持UTF-8：

export PYTHONIOENCODING=utf-8

“超时”错误

解决方案： 通过环境变量增加超时时间：

export LEXLINK_TIMEOUT=90  # Increase from default 60s

更新依赖关系后服务器将不会启动

解决方案： 重新同步依赖关系：

uv sync --reinstall

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 为新功能编写测试
4. 确保所有测试通过(uv run pytest)
5. 提交更改(git commit -m 'Add amazing feature')
6. 推送到分支(git push origin feature/amazing-feature)
7. 打开拉取请求

许可证

这个项目是开源的。有关详细信息，请参阅LICENSE文件。

致谢

• law.go.kr -韩国国家法律信息API
• 主控程序 -基于Anthropic的模型上下文协议
• 韩国法律mcp -缓存、法律名称解析和链工具的灵感（第9阶段）

支持

• 问题：
• law.go.kr API： 官方文件

______________________________________________________________________

更新日志

v2.1.0-2026-03-30

新增：缓存、法律名称解析、链工具（第9阶段）

• 添加了智能工具TTL缓存(cache.py)：搜索1小时，文章24小时，人工智能搜索30分钟
• 新增法律名称/缩写解析(resolver.py)：52个种子别名+动态学习
• 增加了5个第9阶段链式工具： chain_full_research, chain_amendment_track, chain_dispute_prep, chain_law_system, cache_stats
• 灵感源自 韩国法律mcp
• 看 更改日志.md 有关完整详细信息

v2.0.0-2026-03-30

主要版本：第7阶段工具，JSON默认，参数部分

• Added 18 new Phase 7 tools（自治法规、条约、法令信息知识库、委员会决定书、中央部门解释、特别行政审判）
• JSON现在是默认的响应格式（以前是XML）
• 添加 sections="summary" 判例法服务工具参数
• 将共享逻辑重构为 _helpers.py
• 看 更改日志.md 有关完整详细信息

v1.5.0-2026-02-28

重构：删除Smithery依赖关系

• 移除 smithery 包和8个可传递依赖项
• 将OC分辨率简化为2层（工具arg>env-var）
• 添加 stdio_server.py stdio传输的入口点
• 看 更改日志.md 有关完整详细信息

有关完整的更新日志（v1.0.0–v2.1.0），请参阅 更改日志.md.

______________________________________________________________________

由...驱动 主控程序