contract-compass

合同指南针 🧭 (Contract Compass)

韩国公共采购法律 MCP 服务与 Web 服务 — 用于决定合同方式的确定性规则 引擎（直接根据法规编码了 94 条规则）、可搜索的韩国采购法规、规章和裁决表语料库， 以及来自 law.go.kr 的实时法院判例和权威解释。 所有 MCP 工具均不使用大模型：由你的 AI 客户端进行推理，本服务 提供可验证的法律依据。远程端点：https://contract.sallim.app/mcp

公共合同方式决定助手 — 基于《国家合同法》《地方合同法》等公共合同法规， 以确定性的方式指引拟采购合同（工程、服务、货物）可采用的合同方式（招标、私人合同、限制性竞争等） 及其法律依据。它是开源 Web 服务 + MCP 服务。

• 决策向导：输入合同类型、估算价格和条件后，规则引擎（直接根据法规编码的 94 条规则） 会列出可采用的合同方式、确定中标方的方式和资格审查标准，并附上候选项及依据条文
• 法规聊天机器人（Ask）：基于《国家合同法》法规、合同例规、审计院公共合同实务指南等公开语料库 进行 RAG 搜索并提供引用答复（仅限 Web UI）
• MCP 服务（不使用大模型）：Claude、ChatGPT、Cursor 等 AI Agent 可直接查询规则引擎判定结果、法规条文、 例规、资格审查细则（含附表）、判例与法规解释案例（law.go.kr 实时数据）
• 支持机构类型：国家机关 / 地方自治团体 / 公营企业与准政府机构配置
• 优先采用确定性判定：合同方式由规则引擎而非大模型决定——相同输入始终得到相同 结果。大模型仅用于 Web 聊天机器人和生成说明（即使没有密钥，核心功能也能运行）

⚠️ 免责声明：本服务仅用于提供信息，不构成法律咨询或权威解释。 资格审查通过分数、中标下限率及各类限额可能因采购机构的细则和法规修订而异， 因此实际采购前，请务必向所属机构的合同部门确认并查阅现行法规。

使用 MCP 服务

远程端点（Streamable HTTP）：https://contract.sallim.app/mcp 免费：每个 IP 每天 50 次调用（所有工具） · 付费密钥：提高限额 — 价格说明

工具列表（11 种）— 工具

下表直接取自实时服务的 tools/list 响应（实测于 2026-08-18，涵盖全部 11 种）。 MCP 目录和爬虫会静态读取此仓库并据此查找工具名称，因此此表会与服务的实际 工具列表保持一一对应（不一致视为回归问题）。任何人都可以自行复现：

curl -s -X POST https://contract.sallim.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# → decide_contract_method, search_law, search_references, search_cases, get_case,
#   get_law_article, get_law_article_asof, estimate_delay_penalty,
#   delay_exemption_guide, check_price_adjustment, report_issue  (11 tools)

工具	说明	大模型
decide_contract_method	规则引擎确定性判定 — 合同方式候选项、法规依据、资格审查参数	✗
search_law	搜索法规条文（关键词、条文编号、部分匹配、语义回退）	✗
get_law_article	查询完整条文原文（现行）— 法规本身未修订的引文会通过 notes 警告	✗
get_law_article_asof	查询特定时点生效的条文 — 用于处理过往合同、处分和审计（行为时法）	✗
search_references	全语料库综合搜索 — 合同例规、采购厅/行政安全部资格审查细则（附表）、实务指南	✗
search_cases	搜索判例与法规解释案例（law.go.kr 实时数据 — 始终为现行内容）	✗
get_case	判决事项、判决摘要、参考条文 / 查询要旨、答复、理由正文	✗
estimate_delay_penalty	计算延误违约金 — 确定性地应用法定费率、基准金额和 30% 上限（国家与地方费率不同）	✗
delay_exemption_guide	不计入延误天数（免责）事由指南 — 例规事由、需确认的事实、企划财政部/行政安全部答复先例	✗
check_price_adjustment	因物价变动调整合同金额 — 判定 90 天、3%、单项商品门槛（国家 15% / 地方 10%），并提供调整金额及预付款扣除公式	✗
report_issue	报告错误或改进建议（错误引用、未反映修订等）— 直接进入运营审查流程	✗

客户端配置：

# Claude Code
claude mcp add --transport http contract-compass https://contract.sallim.app/mcp

// Cursor (.cursor/mcp.json) — Streamable HTTP 직접 지원
{ "mcpServers": { "contract-compass": { "url": "https://contract.sallim.app/mcp" } } }

// Claude Desktop (claude_desktop_config.json) — mcp-remote 경유
{ "mcpServers": { "contract-compass": {
    "command": "npx", "args": ["-y", "mcp-remote", "https://contract.sallim.app/mcp"] } } }

ChatGPT：在 Settings → Connectors → Developer mode 中将上述 URL 添加为连接器。

安装后，问 AI 这个问题，30 秒内即可确认是否正常 — “国家机关要采购价值 2,000 万韩元的货物，可以采用哪些合同方式？也请提供依据条文。” 如果出现小额私人合同和**《国家合同法施行令》第 26 条第 1 款第 5 项**，则说明运行正常。

工具规范、架构和限额政策的详细信息请参阅 docs/MCP.md。

评估集 — 让其他人也能复核我们的判定

本服务能答对什么、不能答对什么，均已公开在 evaluation.xml 中 （20 道题，答案全部为实测值）。没有编造题目——未经验证的题目会导致 回归测试误报失败。

机器验证由确定性回归测试框架执行。不使用大模型，因此可免费复现：

python3 tools/mcp_regression.py --endpoint https://contract.sallim.app/mcp
# 28 케이스 · exit 0=전부 PASS / 1=회귀 존재 / 2=서버 미도달

每个案例都是对过去实际发现并修复过的缺陷进行回归测试（例如，把已删除的条文 当作依据返回，或在地方政府判定中混入国家标准数值等）。免费套餐每个 IP 每天限 50 次调用， 而此测试集会消耗 28 次，因此每天最多运行 1 次。

按金额区间划分合同方式、私人合同事由和术语指南页面（/g/）的生成、验证与部署流程， 请参阅 docs/PROGRAMMATIC_SEO.md — 页面由规则集派生生成， 请勿手动编辑。 本地 stdio 运行：python3 mcp/server.py（注册：codex mcp add contract-compass -- python3 /path/to/mcp/server.py）

组成

backend/    FastAPI — 룰엔진·RAG·LLM 연동 (frontend/dist 정적 서빙 포함, :8402)
frontend/   React + TypeScript (Vite) — 위저드 UI
mcp/        MCP 서버 — stdio(로컬) / Streamable HTTP(:8403, 원격) · 무LLM 도구 11종
edge/       Cloudflare Worker (contract-edge) — 장애 폴백 게이트 · law API 엣지 캐시
rules/      계약 룰셋 JSON (contract_rules·law_registry 등) ← 결정론 핵심
tools/      법령·예규·별표 수집/인덱싱 파이프라인 (law.go.kr Open API) · 가이드 페이지 생성기
etl/        PDF/DOCX → 청크 → ChromaDB 파이프라인
docs/       MCP 명세 · 장애 전환 런북 · 가이드 페이지 파이프라인
scripts/    스탠바이 동기화 · 반출 전 기밀 검사
tests/      단위·회귀 테스트 + Ask 질문뱅크

快速开始

# 1) 백엔드 의존성 (+ MCP 서버까지 쓰려면 mcp/requirements.txt 추가)
pip install -r backend/requirements.txt

# 2) 프론트 빌드 (Node.js는 빌드 때만 필요)
cd frontend && npm install && npm run build && cd ..

# 3) 환경설정 (선택 — LLM 키 없이도 동작)
cp .env.example .env

# 4) 실행 (rate limiter는 SQLite 공유 — 다중 워커 가능, 코어 수에 맞춰 조정)
python3 -m uvicorn backend.main:app --host 0.0.0.0 --port 8402

构建 RAG 语料库（可选）

如需使用法规聊天机器人和依据搜索，请为公开语料库建立索引：

# 법령 XML을 tools/laws/ 에 준비(law.go.kr Open API — tools/lib/lawgo.py 헬퍼 참조) 후 인덱싱
python3 tools/index_laws.py            # → law_articles 컬렉션

# 계약예규(행정규칙) 수집·인덱싱
python3 tools/fetch_admin_rules.py && python3 tools/parse_admin_rules.py
python3 tools/index_admin_rules.py     # → admin_rules 컬렉션

# 법령 별표·적격심사 세부기준 전문 PDF (부정당 제재기준·하자담보기간·낙찰하한율 별표)
python3 tools/fetch_law_tables.py

# 공개 간행물(감사원 공공계약 실무가이드 등)을 data/source_docs/ 에 넣고
python3 tools/reindex_qa.py            # → public_guides 컬렉션

# BM25 하이브리드 인덱스
python3 tools/build_bm25_index.py

如果没有语料库，向导（规则引擎）仍会正常运行，只有 RAG 搜索结果为空。 判例与法规解释案例查询不依赖语料库，只要有 law.go.kr Open API 密钥（LAW_API_KEY）即可使用。

数据来源（均为公开资料）

• 法规、施行令、施行规则、附表、判例、法规解释案例：国家法令信息中心 Open API（注明来源）
• 合同例规（资格审查标准、政府招标与合同执行标准等）：企划财政部行政规则
• 资格审查细则：采购厅、行政安全部行政规则
• 公共合同实务指南：审计院公开出版物
• 货物分类、中小企业间竞争产品：采购厅、中小风险企业部公告

라이선스

MIT