Skip to main content
Glama
Sign In
dongguk-rule-mcp

dongguk-rule-mcp

by buenosiempre-cmd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

동국 규정 MCP

동국대학교 구성원이 AI에서 공식 통합규정관리시스템의 규정·조문·별표·개정 이력을 찾는 읽기 전용 MCP 서버입니다. 기본 rules 프로필은 공개 규정용이며, 내부 재무지식 기능은 별도 finance 프로필로 선택합니다.

구성원 시작 페이지 · 상세 사용 가이드 · 운영 가이드 · CoP 평가 가이드 · GitHub 릴리스

v0.12.0은 HWP 원문을 우선해 조문을 비교하고, 표의 셀 좌표·병합 범위·값과 포함된 그림의 파일 내용을 함께 비교합니다. 문서마다 실제 추출 범위와 미지원 항목을 표시하며, HWP를 읽지 못해 HTML로 대체한 결과는 부분 비교로 남깁니다. v0.12.0 변경 기록에서 범위를 확인하세요. 출장비·외부 강사료의 교내 규정·한국법령 공동 조회 기능은 유지합니다. 자동 법령 연계 안내 · v0.10.4 변경 기록 · 이전 개선 기록 · 빠른 사용과 운영 설정

개발판 v0.12.2는 “여비규정 별표를 보여줘” 같은 자연어 질문에서 별표를 놓치는 문제를 고치고, 표 아래 여러 문단의 주석을 함께 반환합니다. 별표 번호·가지번호를 구분하며, 원문에서 별표 본체를 찾지 못하면 미확인 상태를 표시합니다. 별표 조회 수정과 이전 유지보수 및 새 기능 검토에 범위·검증을 정리했습니다. 아래 설치 링크는 게시된 v0.12.0을 가리킵니다.

시작하기

방법

준비

연결

공용 서버

원격 MCP 지원 앱, 운영자가 개인/그룹별로 발급한 인증정보

https://dgu.kr-univ-rules.com/mcp/rules

내 PC

Node.js 20.19 이상, 로컬 MCP 지원 앱

아래 GitHub 릴리스 설치, 공유 토큰 불필요

공용 연결의 인증정보는 운영자에게 받습니다. 기존 관리자 토큰을 전 구성원에게 공유하지 않습니다. 앱·요금제·기관 정책별 연결 가능 여부는 실제 환경에서 확인해야 합니다.

개인 설치

npm 레지스트리는 현재 미발행입니다. GitHub의 고정 버전 패키지로 설치합니다.

npm install -g https://github.com/buenosiempre-cmd/dongguk-rule-mcp/releases/download/v0.12.0/dongguk-rule-mcp-0.12.0.tgz
dongguk-rule-mcp --version
dongguk-rule-mcp --doctor --json

tgz를 내려받아 npm install -g ./dongguk-rule-mcp-0.12.0.tgz로 설치해도 됩니다. 설치 권한이 제한된 기관 PC에서는 직접 실행 방법 또는 공용 연결을 확인하세요.

사용할 앱의 설정 예시를 출력합니다. 아래 중 하나를 선택해 기존 MCP 설정에 추가한 뒤 앱을 완전히 종료하고 다시 실행합니다.

dongguk-rule-mcp --print-config codex
dongguk-rule-mcp --print-config claude
dongguk-rule-mcp --print-config cursor

업데이트 뒤에는 설치 파일의 --version, 공용 서버의 /health, 실제 앱 연결의 get_service_info 버전을 각각 확인합니다. Codex의 기존 연결이 구버전을 유지하면 앱을 완전히 종료한 뒤 다시 실행하고 같은 도구로 재확인합니다. Aside의 도구 목록 갱신과 확인 절차는 운영 가이드를 따릅니다.

출력은 현재 Node와 설치 경로를 사용하며 앱 설정을 직접 변경하지 않습니다. 패키지를 이동·삭제한 경우 새 경로에서 설정을 다시 출력합니다. --doctor --json은 오프라인 설치 점검이고, --doctor --json --live는 대표 공개 규정 조회를 추가합니다. 설치 진단만으로 앱 연결·모든 원문·업무 적용이 검증되지는 않습니다.

첫 질문

동국 규정 MCP의 get_service_info로 버전과 도구를 확인해줘. 이어서 lookup_dongguk_rule로 출장 관련 규정을 찾아줘. 소속·캠퍼스는 [입력], 신분은 [입력], 업무 기준일은 [YYYY-MM-DD]야. 정확한 규정명·LAW_ID·HISTORY_ID·조문/별표·원문 링크를 보여주고, 적용범위·시행일·표의 행과 단위를 확인하기 전 금액이나 전결권자를 확정하지 마.

평소 빠르게 질문하기

연결 확인 후에는 get_service_info를 매번 부를 필요가 없습니다. 규정명과 핵심어를 포함해 바로 조회하고, 근거가 충분하면 같은 검색·본문·목차를 반복 조회하지 않습니다.

동국규정에서 여비규정의 국내 숙박비 기준을 찾아줘. 관련 조문·별표와 원문 링크를 먼저 보여주고 핵심만 짧게 정리해줘. 근거가 부족하거나 잘렸으면 그 부분만 추가 확인해줘.

lookup_dongguk_rule 한 번으로 검색·최신 개정본·원문 HWP·관련 별표를 함께 받습니다. 짧은 답변과 별개로 필요한 표의 행·단위·주석, 적용범위와 시행일은 확인해야 합니다. 앱 지침 예시와 캐시 사전 준비

급여·출장비·위임전결·과거 감사·기안문 인용에 바로 적용할 질문과 도구 입력 예시는 업무 활용 가이드를 참고하세요.

Related MCP server: korean-university-regulation-mcp

공개 규정 도구 — 기본 10개

도구

용도

get_service_info

버전·프로필·도구 범위·이용 안내 확인

lookup_dongguk_rule

기본 조회: 자연어/규정명 검색 → 개정본 → HWP 조문·별표 발췌; law_id 직접 선택 지원

search_rule

제목·전문으로 규정 후보 목록 검색

get_rule_content

선택한 규정의 본문·조문·장·키워드 조회

get_rule_toc

목차 조회

list_rule_history

개정 이력 조회

applicable_rule

기준일 이전 개정본 후보와 부칙의 명시 시행일 대조

compare_rule_versions

HWP 조문 우선 비교와 별표·서식 텍스트, 표 셀·병합 범위, 그림 파일 내용 비교

verify_rule_citations

비식별 문장의 규정명·조문·제목·항 인용 실존 점검

search_rule_deep

여러 규정의 전문과 관련 조문 탐색

기본 단일 조회에서 후보가 모호하면 AMBIGUOUS_RULE과 후보 목록을 반환합니다. 제목·적용범위를 확인한 뒤 후보의 LAW_ID를 lookup_dongguk_rule의 law_id로 보내 선택합니다. 관련 없는 첫 검색 결과를 업무 근거로 확정하지 않습니다.

캠퍼스 자동필터는 없습니다. 공식 화면의 LAWGROUP은 캠퍼스 구분이 아닌 문서 종류입니다. 잘못된 seoul=1 / wise=2 매핑을 제거했습니다. campus는 업무 맥락으로 보존하고 전체 통합목록을 검색하며 filterApplied:false를 표시합니다. 서울·WISE·법인 등 소속과 교원·직원·학생 등 대상의 적용범위는 원문에서 확인해야 합니다. 공식 검색 화면, 통합 규정목록 — 2026-09-08 확인.

근거의 범위와 한계

  • 시점: 최신 연혁은 최대 10분 캐시합니다. applicable_rule은 개정일을 바탕으로 후보를 찾으며 시행일·경과조치·소급 적용까지 최종 확정하지 않습니다.

  • 원문 품질: HWP 추출 실패·HTML 대체·빈 본문·발췌 잘림·검색어 미일치를 구분합니다. 비교 결과에는 문서별 추출 범위와 실제 미지원 객체·누락 진단을 남깁니다. 공식 API가 아닌 웹 원문 파싱이므로 사이트 변경의 영향을 받습니다.

  • 개정 비교: 양쪽 개정본의 HWP 조문을 우선 비교합니다. HWP를 읽을 수 없으면 HTML 조문으로 대체하고 부분 상태와 대체 사유를 표시합니다. 기본값인 include_appendices:true에서는 별표·서식 텍스트와 표의 셀 좌표·행/열 병합 범위·값, 포함된 그림 파일의 SHA-256 해시도 비교합니다. include_appendices:false는 별표·서식 비교를 생략하며 HWP 조문 우선 원칙은 유지합니다.

  • 결과 해석: 그림 파일의 동일·변경 판정은 OCR, 그림 속 문구의 의미 해석 또는 페이지 배치 비교를 뜻하지 않습니다. 실제 추출 누락·미지원 객체·식별 모호성은 부분 상태로 남기며 “변경 없음”으로 단정하지 않습니다. 시행일과 업무 적용성은 부칙·적용범위를 별도로 확인합니다.

  • 인용: 인용의 실존 확인과 해당 업무의 적용 적합성은 다릅니다. 검색 0건·확인 필요·부분 조회는 검증 통과가 아닙니다.

  • 업무와 데이터: 공개 rules는 로그인 쿠키와 내부 지식팩을 사용하지 않습니다. 개인별 급여·계좌·학생기록·인증정보를 입력하지 않습니다. 신고·지급·결재 또는 외부 발송을 수행하지 않습니다.

모든 도구는 읽기용 Markdown content와 기계용 structuredContent를 함께 반환합니다. v0.10.2부터 structuredContent를 표시하지 않는 클라이언트에서도 확인할 수 있도록 get_service_info의 version·profile·toolCount와 lookup_dongguk_rule의 sourceType·evidenceStatus·부분 조회 사유를 Markdown에도 표시합니다. 자동화에서는 ok, data, error.code와 개별 원문의 경고·부분 상태를 함께 확인합니다. 규정명·LAW_ID·HISTORY_ID·조문/별표 위치·기준일·조회일·원문 URL을 기록하면 근거를 다시 확인할 수 있습니다.

v0.10.1의 lookup_dongguk_rule은 응답과 규정별 evidenceStatus(retrieved/partial) 및 규정별 incompleteReasons를 반환합니다. HWP 대체·빈 발췌·글자 수 제한·미확정 후보는 부분 조회이며, retrieved도 발췌 확보만 뜻하고 적용성 판단은 아닙니다. rule_keyword와 query를 함께 보내도 질문으로 관련 부분을 찾으며 명시한 terms가 우선합니다. 비정상 검색 페이지는 NOT_FOUND 대신 UPSTREAM_FORMAT_CHANGED로 반환하고 새 캐시에 저장하지 않습니다.

공용 서버와 선택 기능

HTTP는 stateless Streamable HTTP이며 MCP 경로는 POST 요청을 사용합니다.

경로

범위

/, /guide

인증정보를 포함하지 않는 구성원 안내 페이지

/mcp/rules

서버 프로필과 무관하게 공개 규정 10개 도구, 설정한 인증 적용

/mcp

운영자가 지정한 프로필의 도구, 기존 연결 경로

/health, /ready

프로세스·요청 수용 상태; 원문 조회 성공을 의미하지 않음

/status

관리용 인증이 필요한 집계 운영 상태

운영자가 개인 또는 그룹별 자격증명을 발급·회수하고 만료·허용 경로를 관리합니다. 등록 파일은 SHA-256 해시를 보관하며 --token-file 또는 DONGGUK_MCP_TOKEN_FILE로 지정합니다. 설정 예시와 발급 명령은 운영 가이드에 있습니다. 원격 노출에는 HTTPS와 인증을 사용합니다.

# 접근제한 운영 폴더의 토큰 등록 파일을 지정
dongguk-rule-mcp --http --profile rules --host 127.0.0.1 --port 3845 --token-file /secure/dongguk/tokens.json

공용 서버는 Mac mini에서 운영되며 잠자기·전원·인터넷·터널·공식 원문 서버 상태에 따라 중단될 수 있습니다. 전교 동시 이용 규모·기관 SSO·모든 구성원의 앱 연결·현업 시간절감은 별도 검증 대상이며, 이 릴리스가 전원 계정 개통이나 가용성 SLA를 의미하지 않습니다.

--profile finance 또는 DONGGUK_MCP_PROFILE=finance를 선택하면 get_finance_context, get_finance_evidence, search_finance_handbook, review_finance_case가 추가되어 14개 도구가 됩니다. 내장 출장비·외부 강사료 공동 조회는 내부 자료팩 없이 사용할 수 있습니다. 그 외 기존 재무 업무 카드 조회는 검토한 비식별 지식팩을 DONGGUK_FINANCE_PACK_PATH로 별도 연결해야 합니다. 법령 연계와 로그인 쿠키도 선택 프로필의 운영 설정으로 관리합니다. 내부 자료는 공개 저장소·패키지에 포함하지 않습니다.

소스 실행과 검증

git clone --branch v0.12.0 https://github.com/buenosiempre-cmd/dongguk-rule-mcp.git
cd dongguk-rule-mcp
npm ci
npm test
npm run test:live
node src/index.js --doctor --json
npm pack --dry-run

명령

확인 범위

npm test / npm run test:offline

파서·입력·근거·MCP·HTTP·프로필 등 오프라인 회귀

npm run test:live

새 MCP 프로세스에서 공식 원문 조회·연혁·별표 등 대표 경로

npm run test:live:cop

학사·인사·회계 등 대표 업무 규정의 LAW_ID 직접조회·최신 연혁·본문 연결 확인

npm run doctor -- --json

설치와 도구 등록; --live로 대표 원문 조회 추가

npm run audit:deps

설치 의존성의 알려진 취약점 조회; CI에서도 실행

npm run benchmark

로컬 HTTP 부하 측정; 전교 운영 용량이나 원문 서버 SLA 검증은 아님

npm run issue-token -- --help

운영자용 개인/그룹 자격증명 발급 도구 사용법

실원문 검사는 원문 서버에 접근 가능한 네트워크가 필요합니다. HTTP 오류만으로 특정 IP 차단을 단정하지 않습니다. 자동 검사와 현업 효과는 구분하고, 실제 앱·캠퍼스·직군별 평가는 빈 평가 양식으로 기록합니다.

추가 설정: DONGGUK_RULE_ALIASES는 부서별 규정 별칭 JSON, DONGGUK_MCP_NO_CACHE=1은 디스크 캐시 비활성화입니다. 나머지 실행 옵션은 dongguk-rule-mcp --help와 운영 가이드를 확인하세요.

라이선스·기여

MIT. 원본 Python 구현: 서준호. Node.js MCP 포팅·운영 개선: 오승훈. korean-law-mcp에서 영감을 받았습니다.

GitHub Issues에 버전·비식별 재현 질문·오류코드를 남겨주세요. 개인 정보·인증값·내부 문서를 첨부하지 않습니다.

Finance Desk 통합 기능과 외부 자료팩 설정

Available Tools

10 tools
applicable_ruleA
Read-onlyIdempotent

기준일(date) 이전에 개정된 동국대학교 규정 후보를 찾아, 해당 시점 본문과 현행 대비 변경 요약을 반환합니다. 소급 업무·감사 대응·과거 지급기준 확인용. HISTORY_ID를 몰라도 날짜만으로 조회됩니다. 개정일과 실제 시행일이 다를 수 있음을 항상 안내합니다. 최신 규정 질문에는 lookup_dongguk_rule을 사용하세요.

Inputs: date (required), law_id, article, max_changes, +2 more. Returns: ok, data, tool, error

compare_rule_versionsA
Read-onlyIdempotent

원본 HWP의 조문·별표와 표의 셀·병합 구조, 그림 파일 변경을 비교합니다. 원문 실패 시 HTML 대체 여부와 구체적인 추출 진단을 표시합니다. to_history_id 생략 시 최신 개정본입니다.

Inputs: law_id (required), from_history_id (required), article, max_changes, +2 more. Returns: ok, data, tool, error

get_rule_contentA
Read-onlyIdempotent

LAW_ID를 이미 알고 특정 조·장만 볼 때 사용하는 보조 도구. 별표·금액표가 필요하면 lookup_dongguk_rule을 사용하세요.

Inputs: law_id (required), grep, head, article, +2 more. Returns: ok, data, tool, error

get_rule_tocA
Read-onlyIdempotent

규정 목차(장·절·조) 빠른 조회.

Inputs: law_id (required), history_id. Returns: ok, data, tool, error

get_service_infoA
Read-only

동국 규정 MCP 버전·공통/내부 기능 범위·캠퍼스 검색 한계·입력 안내를 확인합니다.

Inputs: no named parameters. Returns: ok, data, tool, error

list_rule_historyB
Read-onlyIdempotent

규정 개정 연혁 목록 조회.

Inputs: law_id (required). Returns: ok, data, tool, error

lookup_dongguk_ruleA
Read-onlyIdempotent

동국대학교 규정 질문의 기본·우선 도구. 자연어 query 또는 짧은 rule_keyword를 받아 규정 검색→최신 원문 HWP→관련 조문·별표(금액표 포함)를 한 번에 반환합니다. 근거가 충분하면 중복 조회를 생략하세요. partial·모호한 후보·적용범위 미확인 시 추가 확인이 필요합니다.

Inputs: query, terms, campus, law_id, +5 more. Returns: ok, data, tool, error

search_ruleA
Read-onlyIdempotent

규정 후보 목록만 필요할 때 사용하는 보조 도구. 일반적인 동국대학교 규정 질문은 lookup_dongguk_rule을 먼저 사용하세요.

Inputs: keyword (required), limit, campus, offset, +1 more. Returns: ok, data, tool, error

search_rule_deepA
Read-onlyIdempotent

여러 규정의 전문을 탐색해야 할 때만 사용하는 보조 도구. 단일 규정 질문에는 lookup_dongguk_rule을 사용하세요.

Inputs: query (required), top, per_doc. Returns: ok, data, tool, error

verify_rule_citationsA
Read-onlyIdempotent

기안문·품의서·공문·AI 답변 텍스트에 인용된 동국대학교 규정 조문을 실제 규정집과 대조 검증하는 환각 게이트. 「규정명」 제N조(제목) 제N항 표기를 추출해 규정 실존, 조문 실존(본칙 존재 범위 안내), 조문 제목 일치, 항 번호까지 확인합니다. 결재 전 인용 점검에 사용하세요. 규정 내용 질문에는 lookup_dongguk_rule을 사용하세요.

Inputs: text (required), campus. Returns: ok, data, tool, error

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation4/5

    The toolset establishes a clear primary entry point (lookup_dongguk_rule) and explicitly labels search_rule, search_rule_deep, get_rule_content, and get_rule_toc as auxiliary, so the intended hierarchy is mostly clear. However, multiple overlapping retrieval/search tools still create some risk of misselection for an agent that does not carefully follow the Korean-language guidance.

    Naming Consistency4/5

    All names use snake_case and are mostly verb_noun (get_rule_toc, list_rule_history, search_rule_deep, verify_rule_citations). The adjective_noun 'applicable_rule' is a minor outlier, and auxiliary qualifiers like 'deep' and 'dongguk' are not fully systematic, but overall naming is predictable.

    Tool Count5/5

    Ten tools is well within the appropriate range for a regulation-domain server, and each covers a distinct operation: primary lookup, candidate search, content/TOC retrieval, history, version comparison, date-applicable lookup, citation verification, and service info. No tool appears purely redundant at the count level.

    Completeness4/5

    Coverage is broad: search, retrieval, TOC, history, version diff, point-in-time lookup, citation verification, and service diagnostics are all present. A minor gap is the absence of a direct 'get full regulation by LAW_ID' tool without first querying or drilling into the TOC/article, though agents can work around it.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers