EU Tender MCP

Inteligencia estructurada y en vivo de contratación pública europea para PYMEs — como servidor MCP. Busca oportunidades, analiza el riesgo transfronterizo y comprende las licitaciones de la UE, todo desde Claude, Cursor o cualquier cliente MCP.

El valor aquí es información que un LLM no puede saber: oportunidades de licitación actuales, umbrales de la UE, códigos CPV y patrones de riesgo transfronterizo. Está diseñado para una PYME de consultoría, servicios o suministros que quiera presentarse a contratos públicos fuera de su Estado miembro de origen.

Por qué es realmente útil (y no solo otro envoltorio)

Cada herramienta es determinista, tipada y honesta sobre su fuente de datos — nunca inventa oportunidades "en vivo" cuando no hay una clave de API de TED configurada.

Herramientas (7)

Instalación y ejecución

python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/pytest tests/ -q      # 38 tests, incl. a real MCP stdio integration

Iniciar el servidor (stdio)

.venv/bin/eu-tender-mcp
# or
.venv/bin/python -m tendermcp.server

Conectar un cliente

Claude Desktop — añádelo a tu configuración de MCP (claude_desktop_config.json): mcpServers → consulta configs/claude-desktop.json. Apunta PYTHONPATH a la ruta absoluta del repositorio.

Claude Code / Cursor / otros clientes MCP — usa configs/mcp-config.json e instala el paquete (pip install -e .) para que python3 -m tendermcp.server se resuelva.

Modelo de datos

• Proveedor predeterminado: un conjunto incluido de licitaciones de muestra claramente etiquetadas (fuente bundled_sample) para que el MCP funcione de serie, se pueda demostrar y sea totalmente comprobable sin clave.

• TED en vivo (hoja de ruta): registra una clave de API de TED, establece TED_API_KEY e implementa TEDLiveProvider._fetch() (en providers.py, ya esbozado). Hasta entonces, nunca se fabrican datos en vivo — se devuelve la muestra etiquetada en su lugar.

Estructura del proyecto

eu-tender-mcp/
├── tendermcp/
│   ├── server.py        ← FastMCP server wiring all tools
│   ├── knowledge.py     ← CPV codes, notice types, EU thresholds, red-flag rules
│   ├── analyzer.py      ← red-flag scan + SME fit scoring (offline, deterministic)
│   ├── providers.py     ← provider interface + bundled/live providers
│   ├── models.py        ← typed Tender / search-params models
│   ├── intel.py         ← market-snapshot aggregations
│   └── sample_data.py   ← labeled demo tenders
├── configs/             ← Claude Desktop / generic MCP client configs
├── tests/               ← 38 tests including real stdio integration
├── pyproject.toml
└── README.md

Hoja de ruta / notas honestas

• El feed de TED en vivo es la mayor mejora con diferencia: requiere una clave de API de TED/OPEN registrada y una URL de feed de cuenta (específica de la cuenta), que solo puede proporcionar un usuario. La interfaz del proveedor está lista.

• Más reglas de banderas rojas y matices jurisdiccionales están planificados; el analizador es transparente a propósito (genera razones, no falsa precisión).

• No es asesoramiento legal. El analizador es una ayuda de triaje; verifica siempre contra los documentos completos de la licitación.

Licencia MIT.