US Federal Procurement MCP

Федеральная контрактная аналитика для малого бизнеса — в виде MCP-сервера. Ищите контрактные возможности, разбирайтесь в set-aside и кодах NAICS, анализируйте тендерные заявки на соответствие малому бизнесу и риски — прямо из Claude, Cursor или любого MCP-клиента.

Это закрывает самый большой пробел в федеральных контрактах для малого бизнеса (SBA): LLM, обученная на публичном интернете, не может знать актуальные контрактные возможности или надежно воспроизводить правила set-aside, пороговые значения FAR и структуру NAICS, которые определяют, стоит ли вообще подавать заявку. Этот сервер делает эту информацию реальной и доступной для запросов.

Инструменты (8)

Все детерминировано, типизировано и честно указывает источник данных.

Установка и запуск

python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/pytest tests/ -q      # 41 tests incl. real MCP stdio integration
.venv/bin/us-gov-mcp            # or: .venv/bin/python -m usgovmcp.server

Подключение клиента

Claude Desktop / Claude Code / Cursor → см. configs/. Установите PYTHONPATH на этот репозиторий; при желании добавьте SAM_GOV_API_KEY.

Данные

• По умолчанию: встроенный набор четко помеченных примеров возможностей, чтобы сервер работал и был протестирован без ключа.

• В реальном времени (SAM.gov): получите бесплатный публичный API-ключ из своего аккаунта SAM.gov → Account Details → request a public API key. Установите SAM_GOV_API_KEY. Провайдер (SAMGovProvider) уже взаимодействует с api.sam.gov/opportunities/v2/search и протестирован на соответствие реальной структуре ответа. Живые данные никогда не подделываются — пока ключ не установлен, возвращаются помеченные примеры.

Структура

us-gov-mcp/
├── usgovmcp/
│   ├── server.py       ← FastMCP server wiring all tools
│   ├── knowledge.py    ← NAICS, set-asides, FAR thresholds, red-flag rules
│   ├── analyzer.py     ← fit scoring + red-flag scan
│   ├── providers.py    ← bundled + SAM.gov live providers
│   ├── models.py       ← typed Opportunity / search params
│   ├── intel.py        ← market-snapshot aggregation
│   └── sample_data.py  ← labeled demo opportunities
├── configs/
├── tests/              ← 41 tests incl. real stdio protocol integration
├── pyproject.toml
└── README.md

Лицензия MIT. Не является юридической консультацией — всегда читайте полный текст тендера перед подачей заявки.