Microfarm MCP

Интеллектуальная оценка пригодности земли для будущих микро-фермеров — как MCP-сервер, который подключается к любой LLM (Claude, Cursor и т.д.). Он отвечает на два вопроса об участке в США:

1. «Действительно ли эта земля подходит для микро-фермы?» — оценивает климат, доступ к воде, сельскохозяйственный контекст, доступность и риск наводнений на основе бесплатных публичных данных (без ключей, без подписок).

2. «Можно ли построить на ней дом?» — проверка возможности строительства жилья с использованием зоны затопления и сельскохозяйственного контекста, честно признавая, что окончательное разрешение устанавливает ваш округ.

Он также может находить землю на продажу из бесплатных источников и оценивать результаты.

Инструменты

Всё подкреплено доказательствами: каждый сигнал называет свой источник, а отсутствующие данные сообщаются как отсутствующие — никогда не считаются «хорошими».

Источники данных (все бесплатные, без ключей)

• Open-Meteo — геокодирование, исторический климат (осадки, температуры, вегетационные дни), высота над уровнем моря

• OpenStreetMap / Overpass — близлежащие водоёмы, здания, дороги, сельскохозяйственные угодья

• FEMA National Flood Hazard Layer — зона затопления в точке (возможность строительства жилья)

• farms.com + Craigslist + index.cy (Cyprus) — объявления о продаже земли (find_land)

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

python3 -m venv .venv
.venv/bin/pip install -e ".[test]"
.venv/bin/pytest tests/ -q        # 31 tests
.venv/bin/microfarm-mcp           # or: python -m microfarm.server

Пример (что LLM делает для вас)

assess_land("Petaluma, California")
→ state: promising | score: 76
  [positive] ample_precipitation: ~1023 mm/yr
  [positive] long_season: ~363 growing days/yr
  [positive] land_type: farmland
  dwelling_feasibility: requires_review (no flood-zone flag; confirm with county)

assess_land("Polemi, Paphos, Cyprus")   ← works outside the US too
→ state: requires_look | score: 65
  [positive] adequate_precipitation: ~457 mm/yr
  [positive] long_season: ~365 growing days/yr
  dwelling_feasibility: unknown (FEMA is US-only; confirm with Cyprus Planning Authority)

assess_land("Nontron, Dordogne, France")   ← France works too
→ state: promising | score: 76
  [positive] ample_precipitation: ~1416 mm/yr
  [positive] long_season: ~330 growing days/yr
  dwelling_feasibility: unknown (confirm with the local mairie / DDT planning office)

find_land(state="OH", max_price_usd=200000)
→ real listings with price, acres, location, photos, description

find_land(country="CY")   ← Cyprus plots from index.cy
→ real Greek/English listings, titles translated, price in €, size in m²/acres

Тип земли + зона

• Тип земли (сельхозугодья / пастбище / лес / кустарник / застроенная территория / вода) определяется из OpenStreetMap и указывается в каждой оценке.

• Официальное зонирование (что вам юридически разрешено строить/использовать землю) недоступно из бесплатных национальных данных — оно устанавливается местными органами планирования (округ в США или районный/планировочный офис на Кипре). Инструмент честно отмечает это и указывает, где подтвердить, а не гадает.

Честные ограничения

• Законы о зонировании/жилье являются местными; здесь используется контекст наводнений и сельхозугодий как первоначальная проверка, и вас направляют в планировочный офис — это не заменяет официальное постановление.

• Данные FEMA о наводнениях доступны только для США; за пределами США (например, на Кипре) риск наводнений честно сообщается как недоступный, никогда ложно не указывается «нет опасности».

• landbanksearch / govdeals / farmflip / Bazaraki / land.cy / offer.com.cy доступны только через браузер или защищены от ботов; зарегистрированы, но ещё не обработаны (см. land_sources.browser_only).

Структура

microfarm-mcp/
├── microfarm/
│   ├── server.py       ← FastMCP server (4 tools)
│   ├── engine.py       ← orchestration + cache + find_land
│   ├── providers.py    ← free data providers (geo, climate, elevation, OSM, FEMA)
│   ├── listings.py     ← land-for-sale collectors (farms.com, Craigslist)
│   ├── scorer.py       ← evidence-backed viability + dwelling scoring
│   └── models.py       ← typed models
├── tests/              ← 24 tests (mocked providers, deterministic)
├── .github/workflows/ci.yml
└── pyproject.toml

Лицензия MIT. Не является финансовой, юридической консультацией или консультацией по недвижимости — проверяйте каждый объект лично.