Microfarm MCP

예비 소규모 농부를 위한 토지 생존 가능성 인텔리전스 — Claude, Cursor 또는 MCP를 지원하는 모든 AI에 연결하여 특정 토지에 대해 중요한 두 가지 질문에 답하는 무료 오픈소스 MCP 서버:

1. 이 땅이 실제로 식량 재배에 적합한가?

2. 이곳에 주택을 합법적으로 지을 수 있는가?

…그리고 그 점수를 매기기 위해 판매 중인 실제 토지를 찾아냅니다.

투기꾼이 아닌 관리자를 위한 도구.

왜 존재하는가

모든 사람이 땅을 소유해야 한다 — 그것이 당신을 부자로 만들기 때문이다. 돈도, 좋은 차도 아닌 — 경작하고, 키우고, 풍요롭게 할 수 있는 땅; 당신과 가족, 이웃, 공동체를 위한 땅; 동물을 먹이고 생명을 유지하는 땅.

— 이 프로젝트가 존재하는 이유

부동산 시장이 토지로 하는 일의 대부분은 투기입니다. 이 도구는 소유하고, 살고, 돌보기 위한 땅을 원하는 사람들을 위한 것입니다 — 물, 표토, 작업 가능한 계절, 그리고 실제로 그 위에 지을 수 있는지에 대한 정직한 답변. 추측하지 않습니다: 모든 신호는 명명된 공개 소스에서 나오며, 알 수 없는 것은 절대 발명하지 않고 표시합니다.

미국, 프랑스, 키프로스에서 작동 — 그리고 Open-Meteo + OSM에 데이터가 있는 모든 곳에서 토지를 점수화합니다. 국가별로 정확히 제공되는 것이 다르므로, 정직한 그림은 다음과 같습니다:

Related MCP server: Plantos MCP Server

국가별 지원 범위

판정 범례: ✅ = 지금 작동 · ⚠️ = 작동하지만, 정직한 "현지 확인" 메모 포함 · 🔜 = 등록되었지만 브라우저 필요 (참조 land_sources.browser_only)

전 세계 vs 국가별 특화:

• 전역 (거의 모든 곳에서 작동): 기후 (강수량, 재배 기간, 내한성), 수자원, 농지, 토지 유형, 도로/접근성 — 이것이 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가 간단한 경로입니다.

그런 다음 어시스턴트에게 물어보세요:

"도르도뉴의 이 땅이 소규모 농장에 적합한지, 그리고 그 위에 집을 지을 수 있는지 알려줘?"

"파포스 지구에서 15만 유로 미만의 토지를 찾아주고, 방문할 가치가 있는 곳을 알려줘."

결과가 어떻게 보이는지

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 데이터는 Open Database License에 따라 © OpenStreetMap 기여자 소유입니다. 목록 콘텐츠는 각 마켓플레이스에 속합니다 — 우리는 그들의 페이지로 표시하고 링크하며, 그들의 이미지를 다시 호스팅하지 않습니다.

토지 유형, 구역 및 "여기에 주택을 지을 수 있나?" 질문

• 토지 유형 (농지 / 목초지 / 숲 / 관목 / 기존 건축 / 수변) 및 나무 피복은 OpenStreetMap에서 감지되어 모든 평가에서 보고됩니다.

• 공식 구역 — 토지에 법적으로 지을 수 있는 것 — 은 무료 국가 데이터에서 제공되지 않습니다. 지역 계획 당국 (미국 카운티, 키프로스 계획 당국, 프랑스 mairie/DDT)이 설정하며, 무료로 기계적으로 조회할 수 없는 소유권 증서 / 지적 / PLU 문서에 기록됩니다. zone 도구는 코드 (프랑스 A/U/N, 키프로스 Γη/ΚΑ, 미국 농업 지구)와 일반적인 건축 규칙 — 농가 주택 / logement de fonction의 특정 조건 포함 — 을 설명하고, 지역 당국에 확인해야 할 정확한 사항을 알려줍니다. 안내서이며, 공식 기록을 대체하지 않습니다.

정직한 한계

• 용도지역 / 주거법은 지역별로 다릅니다. 이 도구는 공개 데이터(홍수 + 농지 맥락)를 기반으로 한 1차 스크리닝이며, 공식 조례를 대체하지 않습니다. 항상 직접 방문하여 지역 담당 공무원과 확인하세요.

• 홍수 데이터는 미국 전용입니다 (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 라이선스 — 자유롭게 사용, 수정, 공유할 수 있습니다.

이것은 재정, 법률 또는 부동산 조언이 아닙니다. 의존하기 전에 항상 직접 방문하여 지역 계획 당국과 함께 부동산을 확인하세요. 데이터는 위의 무료 공개 소스에서 제공되며, 불완전하거나 미흡할 수 있습니다.