EU Tender MCP

중소기업을 위한 실시간, 구조화된 유럽 공공조달 인텔리전스 — MCP 서버로 제공됩니다. 기회를 검색하고, 국경 간 위험을 분석하고, EU 입찰을 이해하세요 — 모두 Claude, Cursor 또는 모든 MCP 클라이언트 안에서.

여기서의 가치는 LLM이 알 수 없는 정보입니다: 현재 입찰 기회, EU 기준액, CPV 코드, 국경 간 위험 패턴. 자국 회원국 밖에서 공공 계약에 입찰하려는 컨설팅, 서비스 또는 공급 중소기업을 위해 만들어졌습니다.

왜 진정으로 유용한가 (그리고 단순한 래퍼가 아닌 이유)

모든 도구는 결정적이고, 타입이 지정되어 있으며, 데이터 소스에 대해 정직합니다 — TED API 키가 구성되지 않았을 때 "실시간" 기회를 절대 지어내지 않습니다.

도구 (7)

설치 및 실행

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

서버 시작 (stdio)

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

클라이언트 연결

Claude Desktop — MCP 구성(claude_desktop_config.json)에 추가하세요: mcpServers → configs/claude-desktop.json을 참조하세요. PYTHONPATH를 저장소 절대 경로로 지정하세요.

Claude Code / Cursor / 기타 MCP 클라이언트 — configs/mcp-config.json을 사용하고 패키지를 설치(pip install -e .)하여 python3 -m tendermcp.server가 실행되도록 하세요.

데이터 모델

• 기본 제공자: 명확하게 표시된 샘플 입찰의 번들 세트(소스 bundled_sample)로, MCP가 기본적으로 작동하고, 데모 가능하며, 키 없이 완전히 테스트 가능합니다.

• 실시간 TED (로드맵): TED API 키를 등록하고, TED_API_KEY를 설정하고, TEDLiveProvider._fetch()를 구현하세요(providers.py에 이미 스텁이 있습니다). 그때까지는 실시간 데이터가 절대 지어지지 않습니다 — 대신 표시된 샘플이 반환됩니다.

프로젝트 구조

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

로드맵 / 정직한 메모

• 실시간 TED 피드가 가장 큰 업그레이드입니다 — 등록된 TED/OPEN API 키와 계정 피드 URL(계정별)이 필요하며, 이는 사용자만 제공할 수 있습니다. 제공자 시임(seam)은 준비되어 있습니다.

• 더 많은 레드플래그 규칙과 관할권 뉘앙스가 계획되어 있습니다; 분석기는 의도적으로 투명합니다 — 이유를 출력하며, 거짓 정밀도를 출력하지 않습니다.

• 법률 자문이 아닙니다. 분석기는 분류(triage) 보조 도구입니다; 항상 전체 입찰 문서로 검증하세요.

MIT 라이선스.