Microfarm MCP

Inteligencia de viabilidad de terrenos para aspirantes a microagricultores — como servidor MCP que se conecta a cualquier LLM (Claude, Cursor, etc.). Responde a dos preguntas sobre una parcela de EE. UU.:

1. «¿Es este terreno realmente bueno para una microgranja?» — puntúa el clima, el acceso al agua, el contexto agrícola, el acceso y el riesgo de inundación a partir de datos públicos gratuitos (sin claves, sin suscripciones).

2. «¿Puedo construir una casa en él?» — una evaluación de viabilidad de vivienda que utiliza la zona de inundación y el contexto agrícola, y que es honesta al señalar que la aprobación final la establece tu condado.

También puede encontrar terrenos en venta a partir de fuentes gratuitas y puntuar los resultados.

Herramientas

Todo está respaldado por evidencia: cada señal indica su fuente, y los datos faltantes se notifican como faltantes — nunca se tratan como «buenos».

Fuentes de datos (todas gratuitas, sin claves)

• Open-Meteo — geocodificación, clima histórico (precipitaciones, temperaturas, días de crecimiento), elevación

• OpenStreetMap / Overpass — agua cercana, edificios, carreteras, tierras de cultivo

• FEMA National Flood Hazard Layer — zona de inundación en un punto (viabilidad de vivienda)

• farms.com + Craigslist + index.cy (Chipre) — anuncios de terrenos en venta (find_land)

Instalación y ejecución

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

Ejemplo (lo que un LLM hace por ti)

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

Tipo de terreno y zona

• El tipo de terreno (tierra de cultivo / pastizal / bosque / matorral / zona urbanizada / agua) se detecta a partir de OpenStreetMap y se informa en cada evaluación.

• La zonificación oficial (para qué puedes construir o usar legalmente el terreno) no está disponible en los datos nacionales gratuitos — la establecen las autoridades locales de planificación (un condado de EE. UU. o una oficina de Distrito/Planificación de Chipre). La herramienta lo señala con honestidad y te indica dónde confirmarlo en lugar de adivinar.

Límites honestos

• La ley de zonificación/vivienda es local; esta herramienta utiliza el contexto de inundación y tierras de cultivo como evaluación inicial y te remite a la oficina de planificación — no sustituye a la ordenanza oficial.

• Los datos de inundación de FEMA son solo para EE. UU.; fuera de EE. UU. (p. ej., Chipre), la inundación se notifica honestamente como no disponible, nunca falsamente como «sin riesgo».

• landbanksearch / govdeals / farmflip / Bazaraki / land.cy / offer.com.cy son solo de navegador o están protegidos contra bots; registrados pero aún no extraídos (ver land_sources.browser_only).

Estructura

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

Con licencia MIT. No es asesoramiento financiero, legal ni inmobiliario — verifica cada propiedad en persona.