airealty-lawmcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LAWMCP_HOST | No | 바인딩 호스트 (기본값 127.0.0.1). 루프백이 아니면 인증이 강제됩니다. | |
| LAWMCP_PORT | No | Streamable HTTP 서버 포트 (기본값 3457) | |
| LAWMCP_BURST | No | 업스트림 전체 버스트 한도 (기본값 8) | |
| LAWMCP_DEBUG | No | 설정 시 stderr 오류 로그 출력 | |
| LAWMCP_TOKENS | No | 토큰 목록을 `이름:토큰,…` 평문으로 직접 지정. 비교는 sha256 + timingSafeEqual, 로그에는 이름만 남깁니다. | |
| LAWMCP_PREWARM | No | 기본 1: 서버가 뜬 뒤 src/prewarm.js 목록 38개 법령의 색인·체계도를 백그라운드로 채움. 0이면 끔. | |
| openlaw_API_KEY | Yes | 법제처 국가법령정보 OPEN API 인증값(OC). open.law.go.kr 가입 후 OPEN API 신청(승인 1~2일) → API인증키관리에서 복사. 환경변수 또는 저장소 상위 폴더의 keys.env(openlaw_API_KEY=…)에서 읽으며 어디에도 출력하지 않습니다. | |
| LAWMCP_CACHE_DIR | No | 디스크 캐시 디렉터리 (사전·조문 번호 색인 24h·체계도 요약 7d·판 목록 6h — 키 없음) | |
| LAWMCP_BUCKET_FILE | No | 버킷 상태를 공유할 파일 경로 | |
| LAWMCP_CONCURRENCY | No | 업스트림 동시 호출 수 (기본값 4, 1~8) | |
| LAWMCP_TOKENS_FILE | No | 토큰 파일 경로 (해시 또는 평문 줄). 기본 파일은 ~/.config/airealty-lawmcp/tokens.txt 이며 서버가 5초마다 변경을 따라갑니다. | |
| LAWMCP_TOKEN_BURST | No | 토큰별 버스트 한도 (기본값 10) | |
| LAWMCP_TOKEN_DAILY | No | 토큰별 일일 호출 한도 (기본값 2000, UTC 자정 초기화 — 일일 상한의 Retry-After는 최대 86400초) | |
| LAWMCP_RATE_PER_SEC | No | 업스트림 전체 초당 요청 한도 (기본값 5) | |
| LAWMCP_REQUIRE_AUTH | No | 1로 설정하면 인증을 강제합니다(루프백 여부·토큰 유무와 무관). 유효 토큰이 0개면 종료 코드 2. | |
| LAWMCP_ALLOWED_ORIGINS | No | 브라우저 Origin 허용 목록(쉼표 구분). 기본은 로컬(localhost·127.0.0.1)만 허용하며 그 밖의 Origin은 403. | |
| LAWMCP_TOKEN_RATE_PER_SEC | No | 토큰별 초당 요청 한도 (기본값 2, tools/call 기준) | |
| LAWMCP_HIERARCHY_BUDGET_MS | No | 체계도 조회 시간 예산(ms) (기본값 1200) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| statute_findA | 법령을 이름·키워드로 찾거나(자동완성·여러 이름 일괄 포함) 공포일 기간으로 거른다. 법령ID·MST·법종·시행일·시행예정 판과 다음 호출 예를 돌려준다. |
| article_getB | 법령 조문 원문을 전문으로 가져온다(여러 조 가능, articles 를 비우면 조문 번호·제목 목차만). 기준일(asOf)에 시행 중인 판을 고르고 항·호·목 구조와 개정 표시를 돌려준다. |
| statute_outlineA | 법령의 구조를 요약한다: 목차(toc), 상하위 법령·행정규칙·자치법규 수(hierarchy), 법률→시행령→시행규칙 위임 트리(delegation), 관련 법령(related). 본문은 담지 않고 article_get 호출을 안내한다. |
| annex_getB | 법령의 별표·서식 목록과 본문을 가져온다. 법률 본문에 별표가 없으면 같은 계열 시행령·시행규칙의 별표·서식을 보충하고, 전체 건수와 페이지, 파일 링크를 돌려준다. |
| statute_historyB | 법령의 시간 축: 판 목록(versions), 한 조문의 개정 이력(article_changes), 신구 대조(old_new), 두 날짜의 조문 문장 비교(compare_dates), 폐지·제명변경 추적(lineage). 기준일 판 선택 규칙으로 시행예정 판을 구분한다. |
| source_searchA | 판례·헌재결정·조세심판·행정심판·법령해석(법제처·국세청·관세청)·위원회 결정문·행정규칙·자치법규·조약·영문법령 등 법령 외 원천을 검색해 전체 건수·ID·사건번호·일자·링크를 돌려준다. |
| source_getB | 판례·결정례·해석례·심판례·행정규칙·자치법규·조약의 본문 1건을 섹션별 전문으로 가져온다(mode=digest 는 원문 문장 발췌, keywords 는 법령명·용어 빈도). 참조조문·참조판례를 구조화해 돌려준다. |
| citation_auditB | 글 속 법령 조문·판례 인용을 뽑아 실제로 존재하는지(기준일 판), 제목·내용이 맞는지 판정한다. 법령명은 사전 일치로만 잡고, 업스트림 장애는 UNCHECKED(환각 판정 아님). |
| precedent_traceA | 판례 한 건의 인용 관계를 본다: 참조조문·참조판례(나가는 참조), 그 사건번호를 본문에 담은 후속 판례(들어오는 인용), 관련 헌재결정, 그리고 '후속 인용 없음/인용됨/변경 가능성' 신호와 근거. |
| contract_risk_scanA | 계약서·약관 전문(200자 이상)을 조항별로 훑어 기간·갱신·증액·대항력·해지·위약금·수선·권리금·면책·중개·신고의 검토 신호를 근거 조문(법령·조문·시행일)과 수치·충돌·등급으로 돌려준다(위법 판정 아님). |
| research_runC | 상담 질문 유형별 다단 조사(임대차·청약·정비사업·중개·용도지역·세금·계약서·행위시법·법체계·개정)를 묶어 단계 요약과 다음 호출을 준다. |
| toolboxB | 보조 도구 카탈로그(법령용어·약칭·개정피드·조문코드·조문참조·링크·유사판례·자치법규연계·행정규칙신구·의미검색·영문법령·조문+판례)를 찾고(list/describe) 실행한다(call). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
The tools mostly target distinct resources and actions: source search vs. source retrieval, statute finding vs. article retrieval vs. outline/history/annex, citation auditing vs. precedent tracing, and contract risk scanning. The main mild overlap is that research_run and toolbox act as orchestration/catalog layers that conceptually touch specialized tools, but their descriptions still make roles clear.
All names use lowercase snake_case, and most follow a readable noun_verb pattern such as source_search, statute_find, article_get, annex_get, source_get, citation_audit, and precedent_trace. Exceptions such as statute_history, statute_outline, contract_risk_scan, and toolbox are still clear, so this is a minor deviation rather than inconsistency.
Twelve tools is well within the ideal 3-15 range for a legal research server and each tool covers a distinct facet: search, retrieval, statute structure, amendment history, annexes, citation audit, precedent tracing, contract scanning, and orchestration. No tool appears redundant or excessive for the stated scope.
The surface broadly covers the legal research lifecycle: statute discovery, article retrieval, annexes, amendment history, source search/retrieval, citation auditing, precedent tracing, contract risk scanning, and auxiliary features via toolbox. Minor gaps such as direct legal-term definitions or amendment alerts are relegated to toolbox rather than first-class tools, but core workflows have no dead ends.