MCP Heuristics - Garden Management System

A Model Context Protocol (MCP) server for tracking and managing permaculture garden beds, built with TypeScript and PostgreSQL.

Overview

This system provides a comprehensive suite of tools for managing garden beds, plants, observations, and harvests. It uses the Model Context Protocol to provide structured interactions with the garden management system.

Features

- Garden Bed Management
- Add new garden beds with metadata
- Update existing garden bed information
- List all garden beds
- Get detailed information about specific beds

- Plant Management
- Add plants to garden beds
- Remove plants from beds
- Track planting dates and species

- Observation System
- Log observations about garden beds
- Track moisture levels, pest presence, and plant health
- View historical observations

- Harvest Tracking
- Log harvest information
- Track harvest quantities and dates
- View harvest history

- Telemetry
- Automatic tracking of tool usage
- Performance metrics collection
- Success/failure monitoring

Technical Stack

- TypeScript
- PostgreSQL (via Neon Database)
- Model Context Protocol SDK
- Kestra (for workflow automation)
- Momento Cache

Prerequisites

- Node.js
- PostgreSQL
- Kestra CLI (for running workflows)

Environment Setup

1. Create a .env file with the following variables:

DATABASE_URL=your_neon_database_url

MOMENTO_TOKEN=your_momento_token