ecfr-mcp

MCP-сервер для API eCFR (Электронный Свод федеральных нормативных актов). Читайте текст FAR, DFARS и всех дополнений FAR агентств без необходимости аутентификации.

Работает с любым MCP-совместимым клиентом (Claude Desktop, Claude Code, Cursor, Cline, Continue, Zed и др.).

Протестировано и усилено в ходе пяти раундов интеграционного тестирования с использованием актуального API eCFR. Исправлено 101 регрессионный тест, охватывающий 2 критические ошибки P0, 26 ошибок P1 с неверными данными и 32 пробела в валидации P2. Полный отчет о тестировании см. в TESTING.md.

Что он делает

Предоставляет API eCFR в виде 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/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. Сервер ecfr появится в вашей панели инструментов MCP с 13 инструментами.

Примеры запросов

• "Получи текущий текст FAR 15.305 (Оценка предложений) и кратко изложи, что он требует."

• "Перечисли все разделы в Части 19 FAR (Программы для малого бизнеса)."

• "Найди определение 'commercial product' в FAR 2.101."

• "Какие разделы 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. Этот сервер разбирает его в чистый текст (заголовки, абзацы, цитаты) перед отправкой в Claude, что значительно экономит контекстные токены.

• Автоматическое определение даты. eCFR отстает на 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 рабочих дня после публикации в Федеральном реестре. Не является официальным юридическим изданием; для официальных цитат используйте ежегодный CFR от GPO.

Сопутствующий навык

Этот MCP дублирует навык ecfr-api с сайта 1102tools.com. Навык основан на Markdown для интерактивного использования в Claude; MCP оборачивает тот же API в виде детерминированных вызовов инструментов для рабочих процессов агентов и автоматизации.

Лицензия

MIT