US Federal Procurement MCP

Inteligencia de contratación federal para pequeñas empresas — como servidor MCP. Busque oportunidades de contratación, comprenda los set-asides y códigos NAICS, y analice solicitudes para evaluar la idoneidad y el riesgo para pequeñas empresas, desde Claude, Cursor o cualquier cliente MCP.

Esto cubre la mayor brecha en la contratación de pequeñas empresas (SBA) de EE. UU.: un LLM entrenado en internet público no puede conocer las oportunidades de contratación actuales ni recordar de forma fiable las reglas de set-aside, los umbrales FAR y la estructura NAICS que determinan si una oferta vale la pena. Este servidor lo hace real y consultable.

Herramientas (8)

Todo es determinista, tipado y honesto sobre su fuente de datos.

Instalación y ejecución

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

Conectar un cliente

Claude Desktop / Claude Code / Cursor → consulte configs/. Establezca PYTHONPATH en este repositorio; opcionalmente añada una SAM_GOV_API_KEY.

Datos

• Predeterminado: un conjunto incluido de oportunidades de muestra claramente etiquetadas para que funcione y se pruebe sin clave.

• En vivo (SAM.gov): obtenga una clave de API pública gratuita desde su cuenta de SAM.gov → Account Details → request a public API key. Establezca SAM_GOV_API_KEY. El proveedor (SAMGovProvider) ya se comunica con api.sam.gov/opportunities/v2/search y está probado con pruebas unitarias contra la forma real de la respuesta. Los datos en vivo nunca se falsifican: hasta que se establezca una clave, se devuelven muestras etiquetadas.

Estructura

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

Con licencia MIT. No es asesoramiento legal: lea siempre la solicitud completa antes de licitar.