us-govdata-mcp

MCP-сервер для данных правительства США — поиск разрешений на строительство, федеральных контрактов (SAM.gov) и национального реестра поставщиков медицинских услуг (NPI/NPPES) из Claude, Cursor или любого клиента Model Context Protocol.

Все три источника данных являются официальными государственными публикациями (городские порталы открытых данных, публичная выгрузка SAM.gov, API CMS NPPES) — без парсинга HTML, без логинов, без хрупких селекторов. Основную работу выполняют три промышленных Apify актора, работающих в вашем собственном аккаунте Apify.

Попробуйте за 30 секунд — без аккаунта, без оплаты

Прежде чем решить, стоит ли это API-токена, запустите без него:

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_DRY_RUN": "1" }
    }
  }
}

Это вся настройка. В режиме сухого прогона каждый инструмент возвращает реалистичные примеры записей плюс точный API-запрос Apify, который был бы отправлен — так вы можете увидеть реальную структуру данных, убедиться, что ваш агент правильно вызывает инструменты, и прочитать информацию о ценах в описании каждого инструмента, без создания аккаунта, вставки токена или каких-либо затрат.

Попросите своего агента что-то вроде "найди разрешения на строительство стоимостью более $500k, выданные в Остине в этом месяце" и наблюдайте за выполнением вызова инструмента от начала до конца. Когда понадобятся живые данные, удалите строку APIFY_DRY_RUN и добавьте APIFY_TOKEN (ниже).

Related MCP server: DOL WHD MCP

Инструменты

* Честное раскрытие информации о ценах: эти инструменты используют платные акторы Apify с оплатой за результат, опубликованные CBLU. Ваш аккаунт Apify списывает средства только за фактически возвращенные записи — никаких подписок или стартовых платежей. Каждый инструмент по умолчанию возвращает 25 результатов за вызов, поэтому типичный вызов стоит доли цента (25 разрешений ≈ $0.13; 25 извещений о контрактах ≈ $0.10; 25 поставщиков ≈ $0.05). Бесплатный план Apify включает ежемесячный кредит платформы, которого достаточно для нерегулярного использования этих инструментов без затрат. Страницы акторов с полной информацией о ценах:

• US Building Permits Scraper

• SAM.gov Contract Opportunities Scraper

• NPI Registry Scraper

Быстрый старт

1. Получите токен Apify (бесплатно, ~2 минуты)

1. Зарегистрируйтесь на https://console.apify.com/sign-up (подойдет бесплатный план).

2. Скопируйте ваш API-токен с https://console.apify.com/settings/integrations.

Сервер запускается и отображает свои инструменты без токена — токен нужен только при фактическом вызове инструмента.

2. Добавьте сервер в ваш MCP-клиент

Claude Desktop (claude_desktop_config.json → Настройки → Разработчик → Редактировать конфигурацию):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Claude Code:

claude mcp add us-govdata -e APIFY_TOKEN=your_apify_token_here -- npx -y github:CBLU2005/us-govdata-mcp

Cursor / Windsurf / другие MCP-клиенты (аналогично Claude Desktop):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_TOKEN": "your_apify_token_here" }
    }
  }
}

Из локального клона:

git clone https://github.com/CBLU2005/us-govdata-mcp.git
cd us-govdata-mcp
npm install && npm run build
# then point your client at: node /path/to/us-govdata-mcp/dist/index.js

Docker:

docker build -t us-govdata-mcp .
docker run -i --rm -e APIFY_TOKEN=your_apify_token_here us-govdata-mcp        # stdio
docker run --rm -p 3000:3000 -e APIFY_TOKEN=... us-govdata-mcp --http 3000    # Streamable HTTP

3. Попросите вашего AI-агента о чем-то вроде

• "Найди разрешения на строительство новых объектов стоимостью более $500k, выданные в Остине в этом месяце, с именами подрядчиков."

• "Любые активные запросы предложений по кибербезопасности для малого бизнеса со сроком ответа после сегодняшнего дня. Включи email контрактного офицера."

• "Найди стоматологов в районе Большого Майами (индекс 331) с номерами телефонов их практики."*

Транспорты

• stdio (по умолчанию) — используется настольными MCP-клиентами: us-govdata-mcp

• Streamable HTTP — конечная точка без сохранения состояния POST /mcp, проверка работоспособности GET /healthz: us-govdata-mcp --http 3000 (или установите MCP_HTTP_PORT=3000)

Переменные окружения

Как это работает

Каждый инструмент проверяет свои аргументы (zod), формирует входные данные для актора и вызывает конечную точку run-sync-get-dataset-items API Apify с вашим токеном через заголовок Authorization: Bearer (никогда в URL). Актор выполняется на платформе Apify в вашем аккаунте, и полученные элементы набора данных возвращаются непосредственно как результат работы инструмента. Этот сервер не хранит состояние и не видит данные, кроме как для их передачи.

Разработка

npm install
npm test          # builds + runs the full smoke suite (introspection, tokenless
                  # error path, dry-run request construction, HTTP transport)

Набору тестов не нужен аккаунт Apify и сеть — он использует APIFY_DRY_RUN=1.

Связанные ресурсы

• Профиль Apify Store со всеми акторами CBLU: https://apify.com/cblu

• Model Context Protocol: https://modelcontextprotocol.io

Лицензия

MIT © CBLU