Microfarm MCP

Интеллект пригодности земли для будущих мелких фермеров — бесплатный MCP-сервер с открытым исходным кодом, который подключается к Claude, Cursor или любому ИИ, поддерживающему MCP, и отвечает на два вопроса, которые важны для участка земли:

1. Действительно ли этот участок хорош для выращивания еды?

2. Могу ли я законно построить на нём дом?

…и находит реальную землю для продажи, чтобы её можно было оценить.

Инструмент для хранителей, а не для спекулянтов.

Зачем это существует

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

— причина, по которой существует этот проект

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

Работает в США, Франции и на Кипре — и оценивает землю в любом месте, где есть данные Open-Meteo + OSM. То, что именно доступно, зависит от страны, поэтому вот честная картина:

Related MCP server: Plantos MCP Server

Охват стран

Легенда вердиктов: ✅ = работает сейчас · ⚠️ = работает, с честной пометкой «подтвердите на месте» · 🔜 = зарегистрировано, но нужен браузер (см. land_sources.browser_only)

Что глобально, а что зависит от страны:

• Глобально (работает почти везде): климат (осадки, вегетационный период, зимостойкость), водные объекты, сельхозземли, тип земли, дороги/доступ — это то, что оценивает assess_land, и использует Open-Meteo + OpenStreetMap, которые работают по всему миру.

• Зависит от страны: объявления find_land поступают с сайтов конкретных стран; зоны затопления берутся из FEMA, который работает только в США — поэтому проверка наводнений для жилья действительно применима только к США, а в остальных местах он честно говорит «подтвердите в местном органе планирования», а не гадает.

Инструменты

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

Быстрый старт

git clone https://github.com/omardaaboul/microfarm-mcp.git
cd microfarm-mcp
python3 -m venv .venv
.venv/bin/pip install -e ".[test]"
.venv/bin/microfarm-mcp            # start the server (stdio)

Подключение к Claude / Cursor / OpenCode / Gemini / любому MCP-клиенту

Microfarm — это стандартный MCP-сервер, поэтому любой инструмент, поддерживающий MCP, может его использовать. Точная настройка зависит от клиента:

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "microfarm-mcp": {
      "command": "python3",
      "args": ["-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

Claude Code — claude mcp add:

claude mcp add microfarm-mcp -- python3 -m microfarm.server

Cursor — .cursor/mcp.json:

{
  "mcpServers": {
    "microfarm-mcp": {
      "command": "python3",
      "args": ["-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

OpenCode — opencode.json (репозиторий) или ~/.config/opencode/config.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "microfarm-mcp": {
      "type": "local",
      "command": ["python3", "-m", "microfarm.server"],
      "cwd": "/absolute/path/to/microfarm-mcp",
      "enabled": true,
      "timeout": 10000
    }
  }
}

Gemini CLI — ~/.gemini/settings.json:

{
  "mcpServers": {
    "microfarm-mcp": {
      "command": ["python3", "-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

VS Code (встроенный Copilot MCP / расширение) — .vscode/mcp.json:

{
  "servers": {
    "microfarm-mcp": {
      "type": "stdio",
      "command": "python3",
      "args": ["-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

Примечание о ChatGPT. ChatGPT поддерживает MCP только как удалённый HTTPS-сервер, и эта возможность в настоящее время ограничена тарифами Business/Enterprise. Локальный сервер stdio (который этот репозиторий запускает по умолчанию) нельзя напрямую подключить к ChatGPT. Чтобы использовать его в ChatGPT, вам нужно разместить сервер удалённо и дать ChatGPT его HTTPS-URL — это реальный шаг, а не настройка конфигурации. Для локального использования Claude, Cursor, OpenCode или Gemini CLI — простые пути.

Затем просто спросите своего ассистента:

«Подходит ли этот участок в Дордони для небольшой фермы, и могу ли я построить на нём дом?»

«Найди мне землю до €150k в районе Пафоса и скажи, какая выглядит стоящей посещения.»

Как выглядят результаты

assess_land("Polemi, Paphos, Cyprus")
→ promising | 75
  [positive] adequate_precipitation: ~426 mm/yr
  [positive] long_season:            ~363 growing days/yr
  [positive] water_access:           5 water feature(s) nearby
  [positive] farmland:               27 farm land tag(s) nearby
  [caution]  land_type:              built-up
  [caution]  tree_cover:             little/no mapped tree cover
  [caution]  privacy:                23 structures nearby
  [positive] soil_fertility:         ~42 g/kg organic carbon
  [caution]  soil_ph:                pH ~7.8
  [caution]  well_recharge:          ~33% clay / ~23% sand
  [positive] access:                 158 road segment(s) nearby

zone("A", "France")   → explains agricultural zone + when a dwelling is allowed
zone("Γη3", "Cyprus") → agricultural zone, min ~4,000m² for one rural dwelling

Источники данных и атрибуция

Это бесплатные публичные источники без ключей, лежащие в основе каждого ответа. Когда вы используете этот проект или его данные в своей работе, пожалуйста, указывайте источники ниже — некоторые требуют атрибуции по лицензии.

Open-Meteo агрегирует национальные метеослужбы; его API лицензирован CC BY 4.0, и мы с благодарностью его используем. Данные OpenStreetMap © участники OpenStreetMap под Open Database License. Содержимое объявлений принадлежит соответствующим маркетплейсам — мы показываем и даём ссылки на их страницы, никогда не размещая их изображения повторно.

Тип земли, зона и вопрос «можно ли построить здесь жильё?»

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

• Официальное зонирование — что вам законно разрешено строить или делать на земле — недоступно из бесплатных национальных данных. Оно устанавливается местными органами планирования (округ в США, Управление планирования Кипра, французская мэрия/DDT) и фиксируется в документах на право собственности / кадастрах / документах PLU, которые не являются свободно машиночитаемыми. Инструмент zone объясняет коды (Франция A/U/N, Кипр Γη/ΚΑ, сельскохозяйственные округа США) и их обычные правила строительства — включая конкретные условия для фермерского жилья / logement de fonction — и точно говорит, что нужно подтвердить в местном органе. Это руководство, а не замена официальной записи.

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

• Законодательство о зонировании/жилье — местное. Этот инструмент — лишь первичная проверка по публичным данным (контекст наводнений и сельхозземель); он не заменяет официальные нормативные акты. Всегда проверяйте лично и с местными чиновниками.

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

• Некоторые сайты объявлений доступны только через браузер (landbanksearch, govdeals, farmflip, Bazaraki, land.cy, offer.com.cy, leboncoin.fr). Они зарегистрированы, но ещё не обработаны; land_sources показывает границу между доступными для обработки и доступными только через браузер.

• Названия георегионов вроде «Limousin» (упразднён в 2016 году) могут не геокодироваться — используйте актуальный город или округ.

• Заголовки греческих объявлений получают базовый перевод по словам; малоизвестные названия мест могут остаться на греческом.

Разработка

.venv/bin/ruff check microfarm tests   # lint
.venv/bin/ruff format --check microfarm tests
.venv/bin/mypy microfarm               # type-check
.venv/bin/pytest tests/ -q             # 43 tests (mocked providers, deterministic)

CI запускает линтер, форматирование, проверку типов, тесты и сборку пакета на Python 3.10 / 3.11 / 3.12.

Структура проекта

microfarm-mcp/
├── microfarm/
│   ├── server.py       ← FastMCP server (5 tools)
│   ├── engine.py       ← orchestration + cache + find_land
│   ├── providers.py    ← free data providers (Open-Meteo, SoilGrids, OSM, FEMA)
│   ├── listings.py     ← land-listing collectors (farms.com, Craigslist, index.cy)
│   ├── scorer.py       ← evidence-backed viability + dwelling scoring
│   ├── zones.py        ← planning-zone explainer (France, Cyprus, US)
│   └── models.py       ← typed pydantic models
├── tests/              ← 43 tests
├── configs/            ← ready-to-use MCP client configs (Claude, Cursor,
│                         OpenCode, Gemini CLI, VS Code, generic)
├── .github/workflows/ci.yml
└── pyproject.toml

Лицензия и отказ от ответственности

Лицензия MIT — вы можете свободно использовать, изменять и распространять его.

Это не финансовый, юридический или риелторский совет. Всегда проверяйте объект лично и в местном органе планирования, прежде чем полагаться на него. Данные получены из указанных выше бесплатных публичных источников и могут быть неполными или неточными.