Farm OS MCP Server

A Model Context Protocol (MCP) server for Farm OS using FastMCP, built with Python and managed with uv.

Features

This MCP server provides tools for managing farm data including:

• Farm information and summaries
• Field management and crop tracking
• Livestock monitoring
• Equipment tracking
• Sensor readings

All data is currently static for testing purposes.

Setup

Prerequisites

• Python 3.10 or higher
• uv package manager (install from https://docs.astral.sh/uv/)

Installation

1. Install uv (if not already installed):

   Windows (PowerShell):

   irm https://astral.sh/uv/install.ps1 | iex
   

   macOS/Linux:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Sync dependencies:

   uv sync
   

3. Install the project:

   uv pip install -e .
   

Usage

Run the MCP Server

uv run python farmos_server.py

Test the Tools

Run the test script to see all available tools in action:

uv run python test_server.py

Available Tools

• get_farm_info(farm_id) - Get detailed information about a specific farm
• list_all_farms() - List all available farms
• get_field_info(field_id) - Get information about a specific field
• list_fields_by_farm(farm_id) - List all fields for a farm
• get_livestock_info(livestock_id) - Get information about livestock
• list_livestock_by_farm(farm_id) - List all livestock for a farm
• get_equipment_info(equipment_id) - Get information about equipment
• list_equipment_by_farm(farm_id) - List all equipment for a farm
• get_sensor_readings(field_id) - Get sensor readings for a field
• search_by_crop_type(crop_type) - Search fields by crop type
• get_farm_summary(farm_id) - Get comprehensive farm summary with statistics

Project Structure

fastmcp/
├── farmos_server.py    # Main MCP server with all tools
├── static_data.py      # Static test data
├── test_server.py      # Test script
├── pyproject.toml      # Project configuration
└── setup.py            # Setup helper script

Static Test Data

The project includes static test data for:

• 3 farms
• 4 fields
• 3 livestock groups
• 3 equipment items
• 3 sensor devices

All data is defined in static_data.py and can be modified for testing purposes.