vivy-yi /gcl-data-service — 法律数据源管理
数据源层次
本服务管理三层数据源，AI 在需要查法条/案例/法规时按优先级调用：
| 优先级 | 数据源 | 标注 | 状态 | 配置 |
|---|---|---|---|---|
| 1 | 元典 MCP | [YD] |
❌ 须付费 | API key |
| 2 | 北大法宝 MCP | [WKL] |
❌ 须付费 | API key |
| 3 | flk.npc.gov.cn | [GOV] |
✅ 免费公开 | 已内置 |
| 4 | gov.cn / court.gov.cn | [GOV] |
✅ 免费公开 | 已内置 |
| 5 | web_search（备选） | [web] |
✅ 免费公开 | 已内置 |
数据源通过 scripts/gcl CLI 统一接入。
可用命令
gcl law <法条名>
查询法条正文。自动遍历 NPC 数据库 → web_search。
用法:
gcl law 民法典第585条
gcl law 中华人民共和国民法典 第五百七十七条
输出示例:
─── 法条查询: 民法典第585条 ───
📘 中华人民共和国民法典
发布: 2020-05-28
🔗 https://flk.npc.gov.cn/detail/...
来源: [GOV]
⚠️ 备选: web_search 结果
🔗 https://pkulaw.com/...
来源: [web]
gcl cases <关键词>
检索裁判文书和案例。
用法:
gcl cases 买卖合同 违约金
gcl cases 数据出境 安全评估 案例
输出示例:
─── 案例查询: 买卖合同 违约金 ───
⚖️ 最高人民法院关于审理买卖合同纠纷案件...
🔗 https://court.gov.cn/...
来源: [GOV]
gcl verify <法条名>
验证法条是否现行有效（检查修订/废止公告）。
gcl search <关键词>
通用搜索——同时查法条和案例。
数据源配置
使用 gcl init 初始化配置，~/.gcl/config.json 内容：
{
"data_sources": {
"npc_api": {"enabled": true},
"web_search": {"enabled": true},
"yuandian_mcp": {"enabled": false, "api_key": ""},
"pkulaw_mcp": {"enabled": false, "api_key": ""}
},
"default_source": "auto"
}
AI 调用流程
当 SKILL.md 需要查法条/案例时：
1. 检查 gcl 是否已安装
→ 如未安装，提示用户运行 gcl init
→ 如已安装，继续
2. 确定数据源优先级
→ 检查 ~/.gcl/config.json 中各源启用状态
→ 从启用顺序最高的开始查
3. 执行查询
→ python3 scripts/gcl law <查询内容>
→ 解析输出，提取原文
→ 标注来源（[YD]/[WKL]/[GOV]/[web]）
4. 验证结果可靠性
→ GCL 来源 → 直接引用
→ web 来源 → 标注 [web]，提示"建议到 NPC 数据库确认"
MCP 集成
将 gcl 注册为 Claude Code 的 MCP server：
运行 gcl mcp-config，输出添加到 ~/.claude/.mcp.json：
{
"mcpServers": {
"gcl-law": {
"command": "/path/to/scripts/gcl",
"args": ["law"]
},
"gcl-cases": {
"command": "/path/to/scripts/gcl",
"args": ["cases"]
}
}
}
注册后可以在 Claude Code 中直接使用：
/gcl:law 民法典第585条
/gcl:cases 合同纠纷 违约金
数据源管理
| 操作 | 命令 | 说明 |
|---|---|---|
| 初始化 | gcl init |
创建 ~/.gcl/config.json |
| 启用 NPC 数据库 | gcl config set npc_api.enabled true |
免费数据源 |
| 启用元典 MCP | 设置 yuandian_mcp.api_key |
须有元典订阅 |
| 启用北大法宝 MCP | 设置 pkulaw_mcp.api_key（详见 references/pkulaw-mcp.md） |
须有北大法宝订阅 |
| 查看状态 | cat ~/.gcl/config.json |
各数据源启用状态 |
| 测试连接 | gcl law 民法典 第1条 |
验证数据源可用性 |
本服务不做什么
- 不存储查询结果——每次查询实时检索
- 不验证法条解释的准确性——只返回原文
- 不替代付费法律数据库——免费源可能不全
- 不处理境外法域查询（香港/澳门/台湾/新加坡须单独接入）
Greater China Legal — shared gcl-data-service v1.0.0