ecfr-mcp

MCP-сервер для API eCFR (Electronic Code of Federal Regulations, электронная версия Свода федеральных нормативных актов США). Читает FAR, DFARS и все ведомственные дополнения к FAR без аутентификации.

Автономное использование MCP — это продвинутый путь, который вы поддерживаете самостоятельно; готовые агенты — поддерживаемый путь для начинающих.

Проверено и доработано в шести раундах интеграционного тестирования против живого eCFR API. 295 регрессионных тестов (182 офлайн, 113 с подключением к живой API) покрывают 2 катастрофические ошибки P0, 26 ошибок P1 с тихим искажением данных, 32 пробела валидации P2 и исправления шестого раунда аудита (белые списки глав раздела 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

Аутентификация не требуется

API eCFR полностью публичный. Никаких 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 описывает встроенные агенты для 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 (Proposal Evaluation) и опиши требования».

• «Перечисли все разделыFloating Part 19 части (Small Business Programs)».

• «Найди в FAR 2.101 определение термина "commercial product"».

• «Что изменилось в FAR за последние 6 месяцев?»

• «Сравни FAR 52.212-4 на 2024-01-01 и 2025-01-01 и покажи изменения».

• «Получи текущий текст DFARS 252.227-7014 (Права на некоммерческое программное обеспечение)».

• «Найди в разделе 48 "organizational conflict of interest" и покажи релевантные секции».

• «Какое ведомство занимает главу 8 в разделе 48? Покажи структуру их дополнений к 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. Секция с определениями — это ~109 КБ XML. find_far_definition разбирает всю секцию на сервере и возвращает только нужные абзацы с контекстом.

Краткий справочник по разделу 48 CFR

Источник данных

Все данные берутся с ecfr.gov, непрерывно обновляемого онлайн-свода федеральных нормативных актов США, сопровождающегося Офисом Федерального регистра. Обновляется ежедневно, обычно через 1–2 рабочих дня после публикации в Federal Register. Не официальное юридиическое издание; для официальных ссылок используйте ежегодный CFR от GPO.

Входит в состав

federal-contracting-mcps: монорепозитория 9 MCP-серверов для данных государственных закупок. Также см. federal-contracting-skills.

Регулирование частоты запросов

Каждый запрос к внешнему API по умолчанию использует предварительный 3-секундный интервал слежения между процессами для защиты от всплесков нагрузки. eCFR не публикует числовых лимитов, поэтому это защитная мера 1102tools, а не требование провайдера. Измените через FEDERAL_API_MIN_INTERVAL_SECONDS, используйте 0 для сознательного отключения и FEDERAL_API_PACING_DIR для переноса локального состояния регулирования.

Лицензия

MIT