Repository avatar
AI Tools
v2.16.3
active

garden-design-mcp

io.github.zaprojektuj-ogrod/garden-design-mcp

Design a garden in 3D with your AI assistant: plot, zones, plants and buildings in Garden Editor

Documentation

Garden Design MCP Server

Let your AI assistant design a garden on your real plot. This MCP (Model Context Protocol) server connects Claude Code, Claude Desktop, Cursor or any other MCP client to the Zaprojektuj-Ogrod.pl Garden Editor, a browser app for garden and landscape design in 2D and 3D. You watch every change appear in the editor as the assistant makes it, then walk through the finished garden in 3D.

Step-by-step setup guide: in English · po polsku

What the assistant can do

  • Find the plot anywhere in the world, on OpenStreetMap or a satellite photo. In Poland it imports the exact parcel boundary and the buildings from the land registry (Geoportal, ULDK).
  • Read your photos and floor plan to put the doors, windows and views on the right walls of the house.
  • Draw what is already there: fences, paving, the driveway, a heat pump on the wall. Nothing that exists is moved without asking.
  • Lay out zones for your wishes at practical sizes (a terrace for six, a path, raised beds, a bench corner), and say so when a wish does not fit instead of shrinking it quietly.
  • Choose plants from a catalog of 2,000+ by sun, soil, hardiness and size, and place them at their mature spread. Surfaces, furniture, raised beds and planters come from the same catalog.
  • Check its own work: planting density per bed, previews of the plan, 2D and 3D views. It saves the design to your account.

It works one step at a time and stops for your sign-off: the site first, then the zones, then the planting.

Quick start

1. Add the server to your AI client. No install is needed: npx downloads and runs it.

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "garden-editor": {
      "command": "npx",
      "args": ["@zaprojektujogrod/mcp-server"]
    }
  }
}

Claude Desktop (Settings → Developer → MCP Servers):

{
  "garden-editor": {
    "command": "npx",
    "args": ["@zaprojektujogrod/mcp-server"]
  }
}

2. Open a garden in the Garden Editor at zaprojektuj-ogrod.pl and switch the MCP connection on in Settings › AI assistant. The editor connects to the server on your computer.

3. Ask your assistant, for example: "Help me design my garden, step by step." Or start from the server's start_design prompt.

Effort. Medium effort is enough. In our tests Claude Opus 5.5 designed as well at medium effort as at high, for about a quarter less. Effort is your client's setting, so the server can't set it. In Claude Code, start with claude --effort medium.

How it works

┌─────────────────┐     stdio      ┌──────────────────┐    WebSocket     ┌──────────────────┐
│  AI client      │ ◄────────────► │   MCP server     │ ◄──────────────► │  Garden Editor   │
│  (Claude, etc.) │                │  (this package)  │  localhost:3333  │  (your browser)  │
└─────────────────┘                └──────────────────┘                  └──────────────────┘

The server runs on your computer and talks to the editor open in your browser over a local WebSocket (ws://localhost:3333). Your garden stays in your account; the assistant runs in your own AI client, on your own subscription or API key.

Setup from source

If you prefer to run from source instead of npx:

git clone https://github.com/zaprojektuj-ogrod/garden-design-mcp.git
cd garden-design-mcp
npm install
npm run build

Then configure your AI client with a direct path:

{
  "mcpServers": {
    "garden-editor": {
      "command": "node",
      "args": ["/path/to/garden-design-mcp/dist/index.js"]
    }
  }
}

Available tools (56)

Tools follow the design funnel: Site → Context → Zones → Detailing → Review. Tools that create or change things take a list (add_objects, update_objects, delete_objects, add_pins, add_zones), one item or many. Call get_design_guide once at the start: it holds the whole workflow, the photo method and the planting rules.

Replies are compact JSON, with numbers rounded and fields the assistant never uses left out, because every reply is re-read on each later turn. A batch answers with ids in input order (null where one failed) and issues for failures and warnings.

Another 17 tools still answer when called but aren't listed, since every listed tool's definition rides along with each request:

  • the one-item twins of the batch tools: add_object, add_zone, add_pin, update_object, delete_object;
  • undo, redo, clear_all, export_state, import_state;
  • set_units, get_view_mode, get_layer_visibility, get_coordinate_system, get_zone_types;
  • connection_status, get_version.

Phase 1: Site

ToolDescription
geocode_addressFind a place anywhere in the world from an address
set_geo_anchorPlace the garden on the map at real-world coordinates
get_geo_anchorGet the garden's place
set_map_backgroundShow or hide a map under the garden: OpenStreetMap, the satellite photo (Poland) or a laid survey map
set_boundaryGive the plot boundary as a polygon in metres (from measurements or traced from the map)
get_parcel_by_coordinatesLand registry parcel by WGS84 lat/lon (Poland)
get_parcel_by_idLand registry parcel by parcel ID (Poland)
get_parcel_by_addressAddress (town, street, number, or one text) → land registry parcel (Poland); several spellings are tried, a plot found only by the map finder is marked approximate
import_parcelImport a parcel as the garden boundary, with the cadastral map behind it (Poland)
import_buildingsImport the buildings on and around the parcel from the land registry (Poland)
get_site_analysisHouse facades by compass side, party walls and the garden depth on each side; the site's main directions for zone edges (axes), whether the garden is large (largeGarden, 400 m² or more), the garden no zone covers yet (blank), and the trees with their trunk and crown
upload_reference_photoUpload a reference photo (kept for the session)
get_reference_photosGet the uploaded reference photos
attach_imageHand the editor a picture from a file on the designer's computer (a survey map, a site plan, a drawing): kept as an attached image for zoom_image and set_survey_map — pictures pasted into the MCP client's chat never reach the editor
zoom_imageA close-up of an image attached in the editor's chat or handed over with attach_image, for reading details
set_survey_mapLay a survey map or site plan to scale under the garden, from two matched points or two points and a distance
map_to_gardenTurn points on the laid survey map into garden coordinates in metres

Phase 2: Context

ToolDescription
add_pinsAdd context pins (door, window, gate, view), one or many
delete_pinDelete a pin by ID
get_pinsGet all pins
get_garden_infoGet garden metadata (name, rotation, boundary, stats)
set_garden_rotationSet north orientation in degrees
get_journalRead the assistant's design journal: its working memory of the garden between sessions, kept with the garden and never shown to the owner
write_journalWrite the journal whole, or with section one heading's section without resending the rest
set_garden_descriptionWrite the garden's description when the owner asks for it or agrees: the design as it stands now, in Markdown, shown with the garden on the website
capture_previewCapture a top-down view as an image the assistant sees inline: 800 px by default; hideZones: true hides zones and pins for that picture

Phase 3: Zones

ToolDescription
add_zonesAdd zones (polygon or path in metres), one or many; each answers with area, narrowest width and overlaps
update_zoneUpdate zone properties
delete_zoneDelete a zone by ID
get_zonesGet all zones
get_objects_in_zoneList objects whose centers fall inside a zone
get_zone_analysisDensity and cover of a zone: planting cover counted once where plants and shapes overlap, the cover of each height layer (ground, shrub, tree), objects by category

Phase 4: Detailing

ToolDescription
search_productsSearch the product catalog by layer and name and/or categoryId
search_plantsFilter plants by kind (tree, shrub, perennial, grass…), sun, soil, hardiness, flower color, height, spread, bloom time, plus an optional name query; each match gives its mature height and spread
get_plant_attributesThe valid filter values for search_plants
get_plant_infoA plant's characteristics, requirements, maintenance level and spacing; full: true adds seasonal care, pests and installation
get_categoriesTop-level categories for a layer
get_subcategoriesLeaf categories under a parent category
get_product_detailsFull product details by ID
get_objectsGet all garden objects (filter by layer; count_only: true for counts only)
add_objectsAdd plants, architecture, ground surfaces or generic plant shapes, one or many (productId or productQuery; a shape by its form and size)
plant_zonesPlant zones with the plants or generic plant shapes the assistant chose: the editor places them in groups of 3–7 in beds, in one row in a screen, a hedge shape as a line along its zone, clear of paths, terraces, lawn and the plants of their own height layer already there (ground cover goes under shrubs and trees), and reports each zone's cover, counted once and per layer
suggest_speciesThe species that fit generic plant shapes — their habit and size, the place's light, soil and hardiness, species a shape's label names first; shapes nothing fits listed apart
swap_shapesSwap shapes for species in place, each at its own catalog size (a hedge as a row, ground cover as one species or a mix); one undo brings the shapes back
update_objectsUpdate objects (position, size, rotation, product; a shape's size within its form's range), one or many
delete_objectsDelete objects by ID, one or many

Phase 5: Review

ToolDescription
get_full_stateSnapshot of the scene; summary_only: true for large scenes
set_view_modeSwitch between 2D and 3D view
set_layer_visibleShow/hide a layer
focus_onFocus the camera on an area
saveSave all changes to the account

The designer's own house

Built from the designer's photos, step by step, out of simple blocks, on the house's land-registry outline (after import_buildings). Kept with the garden as its description and rebuilt wherever the garden opens; no model file is stored.

ToolDescription
house_buildThe main block on the house's outline, at true size and turn, its front on the compass side given; open: true for a structure on posts of its own (a carport, a pergola)
house_set_roofA block's roof: gable, hip, mono-pitch, flat, or none (a post); ridge direction, heights, covering, colour; chimneys, solar panels
house_set_wallsWalls' finish and colour, a lower band, the plinth
house_set_openingsOne facade's windows, doors and facade panels
house_set_blockAdd, change or remove a further block: a wing, a garage; posts and open roofs for a porch, a carport, a pergola
house_previewPictures of the house from the sides asked for, to compare with the photos
house_getThe house as built: position, facades by compass side, blocks, openings

Utility

ToolDescription
get_design_guideThe full design guide: workflow, photo method, zone sizes, journal and description, plant selection

capture_preview: what the assistant sees

capture_preview returns an MCP ImageContent block ({type: "image", data, mimeType: "image/jpeg"}). The connected assistant sees it directly and can describe and check the plan without any file on disk.

It does not write a file to disk. MCP clients (Claude Desktop, Claude Code, Cursor, …) show the image inline, and the server does not keep screenshots. To keep the JPEG, right-click → "Save image as…" on the image in your client, or read the base64 in content[0].data from your own client harness.

MCP resources

URIDescription
garden://infoGarden metadata
garden://zonesAll zones as JSON
garden://pinsAll context pins
garden://objectsAll garden objects
garden://coordinate-systemCoordinate system documentation

MCP prompts

PromptDescription
start_designBegin a new garden design, as the editor's guided set-up does: the site first, then zones and planting, each signed off
continue_designResume an existing garden (assess state, suggest next steps)
optimize_zonesReview and optimize the zone layout within the boundary

Development

Run in development mode (with hot reload):

npm run dev

The server logs to stderr so it does not interfere with MCP stdio communication.

Po polsku

Serwer MCP do projektowania ogrodów z asystentem AI. Łączy Claude, Cursor lub inny klient MCP z edytorem Zaprojektuj-Ogrod.pl. Asystent znajduje działkę (w Polsce z granicami i budynkami z Geoportalu), rysuje to, co już na niej jest, układa strefy według Twoich życzeń i dobiera rośliny z katalogu, a Ty widzisz projekt ogrodu w 2D i 3D. Instrukcja: Konfiguracja serwera MCP.

License

MIT, see LICENSE. Questions and bug reports: zaprojektuj-ogrod.pl/kontakt.

NPM
@zaprojektujogrod/mcp-server
Install Command
npm install @zaprojektujogrod/mcp-server