ecfr-mcp

eCFR(전자 연방 규정집, Electronic Code of Federal Regulations) API용 MCP 서버입니다. 인증 없이 FAR, DFARS 그리고 모든 기관의 FAR 보충 규정 텍스트를 읽을 수 있습니다.

독립 실행형 MCP 사용은 스스로 유지 관리해야 하는 고급 방식입니다. 패키징된 에이전트는 유지 관리되는 초보자용 경로입니다.

실제 eCFR API를 대상으로 한 6차례의 통합 테스트를 거쳐 테스트 및 보강되었습니다. 295개의 회귀 테스트(오프라인 182개, 라이브 연동 게이트 113개)는 2개의 P0 치명적 버그, 26개의 P1 잘못된 데이터를 조용히 반환하는 버그, 32개의 P2 검증 공백, 그리고 6차 감사 수정 사항(타이틀 48 챕터 화이트리스트, 테이블 추출, 부록 접근)을 다룹니다. 전체 테스트 기록은 testing.md를 참조하세요.

제공 기능

eCFR API를 규제 텍스트, 구조, 검색, 버전 이력 및 일반적인 조달 작업 흐름을 포괄하는 13개의 MCP 도구로 제공합니다:

핵심 엔드포인트

• get_latest_date - 가장 최근에 이용 가능한 CFR 타이틀의 날짜를 가져오기(다른 도구 호출 전에 호출)

• get_cfr_content - 섹션, 하위 파트 또는 파트에 대한 구문 분석된 규제 텍스트 가져오기

• get_cfr_structure - 계층형 목차

• get_version_history - 섹션 또는 파트에 대한 개정 이력

• get_ancestry - 브레드크럼 계층 경로

• search_cfr - 계층 필터가 포함된 전체 텍스트 검색

• list_agencies - CFR 참조가 있는 모든 기관

• get_corrections - 타이틀의 편집 수정 사항

워크플로우 편의 기능

• lookup_far_clause - FAR/DFARS 조항 텍스트를 한 번의 호출로 조회(날짜 자동 해석)

• compare_versions - 두 시점의 텍스트 나란히 비교

• list_sections_in_part - FAR/DFARS 파트의 모든 섹션

• find_far_definition - FAR 2.101에서 용어 정의 검색

• find_recent_changes - 특정 날짜 이후 수정된 섹션

Related MCP server: regulationsgov-mcp

인증 불필요

eCFR API는 완전히 공개되어 있습니다. API 키, 등록, 인증 헤더가 필요 없습니다. 그냥 설치하고 사용하면 됩니다.

설치

uvx로 설치(권장)

uvx ecfr-mcp

pip로 설치

pip install ecfr-mcp

소스에서 설치

git clone https://github.com/1102tools-dev/federal-contracting-mcps.git
cd federal-contracting-mcps/servers/ecfr-mcp
pip install -e .

구성

MCP는 공개 표준이며, 호환되는 클라이언트는 이 서버를 실행할 수 있습니다. 유지 관리되고 있는 1102tools Agent Setup Guide는 Codex와 Claude Code에서 패키징된 에이전트를 다루며, 독립 실행형 서버 구성은 다루지 않습니다. 아래 블록을 서버 정의로 사용하고 클라이언트에 맞게 배치를 조정하세요.

{
  "mcpServers": {
    "ecfr": {
      "command": "uvx",
      "args": ["--refresh-package", "ecfr-mcp", "--from", "ecfr-mcp", "ecfr-mcp"]
    }
  }
}

--refresh-package 플래그는 클라이언트가 서버를 시작할 때마다 uv가 PyPI에서 새 릴리스를 확인하도록 지시하므로 수정 사항이 자동으로 적용됩니다. 이 플래그가 없으면 uv는 처음 캐시한 버전을 계속 제공합니다. 시작 시 네트워크 시간이 조금 추가되므로 플랫폼의 MCP 시작 제한 시간이 짧게 설정되어 있다면 상향 조정하세요.

클라이언트를 다시 시작하세요. ecfr 서버가 13개의 도구와 함께 나타납니다.

예시 프롬프트

• "FAR 15.305(제안 평가)의 현재 텍스트를 가져와 요구 사항을 요약해 주세요."

• "FAR Part 19(중소기업 프로그램)의 모든 섹션을 나열해 주세요."

• "2.101에서 '상업 제품(commercial product)'의 FAR 정의를 찾아 보세요."

• "지난 6개월 동안 개정된 FAR 섹션은 무엇인가요?"

• "FAR 52.212-4를 2024-01-01과 2025-01-01 사이의 버전과 비교하고 변경된 사항을 보여주세요."

• "DFARS 252.227-7014(비상업용 컴퓨터 소프트웨어에 대한 권한)의 현재 텍스트를 가져와 주세요."

• "타이틀 48에서 '조직적 이해관계 충돌(organizational conflict of interest)'을 검색하고 관련 섹션을 보여주세요."

• "타이틀 48에서 챕터 8은 어느 기관 소유인가요? 해당 기관의 FAR 보충 규정 구조를 가져와 주세요."

설계 참고 사항

• XML은 서버에서 구문 분석됩니다. eCFR 콘텐츠 엔드포인트는 원시 XML을 반환합니다. 이 서버는 모델에 반환하기 전에 이를 깨끗한 텍스트(제목, 단락, 인용)로 구문 분석하여 컨텍스트 토큰을 크게 절약합니다.

• 날짜 자동 해석. eCFR은 Federal Register보다 영업일 기준 1~2일 늦습니다. 버전 엔드포인트에 현재 날짜를 사용하면 404 오류가 발생합니다. 모든 콘텐츠 도구는 지정하지 않는 한 가장 최근의 사용 가능한 날짜를 자동으로 해석합니다.

• 검색 기본값은 현재 텍스트 기준입니다. date=current를 지정하지 않으면 eCFR 검색은 이미 대체된 것을 포함한 모든 과거 버전을 반환합니다. 기본값인 current_only=True는 중복 결과를 방지합니다.

• 구조 엔드포인트의 제한 사항. eCFR 구조 엔드포인트는 섹션 수준 필터링을 지원하지 않습니다(400 오류를 반환). list_sections_in_part는 파트 구조를 가져와 트리를 탐색하는 방식으로 이 문제를 해결합니다.

• FAR 2.101 최적화. 정의 섹션은 약 109KB의 XML입니다. find_far_definition은 서버측에서 전체 섹션을 구문 분석하고 일치하는 단락만 해당 컨텍스트와 함께 반환합니다.

CFR 타이틀 48 빠른 참조

데이터 소스

모든 데이터는 미국연방규정청(Office of the Federal Register)이 운영하는 지속적으로 업데이트되는 온라인 연방 규정집인 ecfr.gov에서 가져옵니다. 매일 업데이트되며 일반적으로 Federal Register 게재 후 영업일 기준 1~2일 후에 반영됩니다. 공식 법적 판본은 아닙니다. 공식 인용은 GPO의 연례 CFR을 참조하세요.

소속

federal-contracting-mcps: 연방 조달 데이터용 MCP 서버 9개의 모노레포. federal-contracting-skills와 함께 사용합니다.

요청 페이싱

모든 업스트림 요청은 기본적으로 임시적인 3초 크로스프로세스 안티버스트 간격을 사용합니다. eCFR은 수치 한도를 밝히지 않기 때문에 이는 제공업체 요구 사항이 아닌 1102tools차원의 안전 장치입니다. FEDERAL_API_MIN_INTERVAL_SECONDS로 설정을 변경할 수 있으며, 0으로 두면 의도적으로 비활성화되고, FEDERAL_API_PACING_DIR을 사용해 로컬 페이싱 상태를 다른 위치로 옮길 수 있습니다.

라이선스

MIT