ecfr-mcp

eCFR(연방 규정 전자 코드) API를 위한 MCP 서버입니다. 인증 없이 FAR, DFARS 및 모든 기관의 FAR 보충 규정 텍스트를 읽을 수 있습니다.

MCP 호환 클라이언트(Claude Desktop, Claude Code, Cursor, Cline, Continue, Zed 등)와 함께 작동합니다.

실제 eCFR API를 대상으로 5차례의 통합 테스트를 거쳐 검증되었습니다. 2개의 P0 치명적 버그, 26개의 P1 데이터 오류 버그, 32개의 P2 유효성 검사 누락을 수정한 101개의 회귀 테스트가 포함되어 있습니다. 전체 테스트 기록은 TESTING.md를 참조하십시오.

기능

규정 텍스트, 구조, 검색, 버전 기록 및 일반적인 조달 워크플로우를 다루는 13개의 MCP 도구로 eCFR API를 노출합니다:

핵심 엔드포인트

• 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/federal-contracting-mcps.git
cd federal-contracting-mcps/servers/ecfr-mcp
pip install -e .

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

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

Claude Desktop을 재시작하세요. MCP 도구 패널에 13개의 도구를 포함한 ecfr 서버가 나타납니다.

예시 프롬프트

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

• "FAR 파트 19(중소기업 프로그램)의 모든 섹션을 나열해 줘."

• "2.101에서 'commercial product'에 대한 FAR 정의를 찾아줘."

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

• "2024-01-01과 2025-01-01 사이의 FAR 52.212-4를 비교해서 변경된 내용을 보여줘."

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

• "타이틀 48에서 'organizational conflict of interest'를 검색하고 관련 섹션을 보여줘."

• "타이틀 48의 챕터 8을 관할하는 기관은 어디인가요? 해당 기관의 FAR 보충 규정 구조를 가져와 줘."

설계 참고 사항

• 서버 측 XML 파싱. eCFR 콘텐츠 엔드포인트는 원시 XML을 반환합니다. 이 서버는 Claude에게 반환하기 전에 이를 깔끔한 텍스트(제목, 단락, 인용문)로 파싱하여 컨텍스트 토큰을 크게 절약합니다.

• 자동 날짜 해결. eCFR은 연방 관보보다 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에서 가져옵니다. 매일 업데이트되며, 일반적으로 연방 관보 게시 후 1~2 영업일 후에 반영됩니다. 공식 법률 판본이 아니므로, 공식 인용이 필요한 경우 GPO의 연간 CFR을 참조하십시오.

관련 기술

이 MCP는 1102tools.com의 ecfr-api 기술을 미러링합니다. 해당 기술은 대화형 Claude 사용을 위해 마크다운 기반으로 되어 있으며, 이 MCP는 에이전트 워크플로우 및 자동화를 위해 동일한 API를 결정론적 도구 호출로 래핑합니다.

라이선스

MIT