# LiteFarm MCP Server

Model Context Protocol (MCP) server for LiteFarm API integration. Enables AI assistants to interact with LiteFarm farm management data.

## Features

- Farm management (list, get, create, update farms)
- Animal tracking (individual animals and batches)
- Crop management
- Location management (fields, greenhouses, gardens)
- Task management
- Finance tracking (expenses, expense types)
- Direct database access for complex queries

## Setup

```bash
npm install
cp .env.example .env
# Edit .env with your credentials
```

## Environment Variables

See `.env.example` for required configuration:
- `LITEFARM_API_URL` - LiteFarm API endpoint
- `LITEFARM_EMAIL` - Login email
- `LITEFARM_PASSWORD` - Login password
- `DATABASE_URL` - PostgreSQL connection string (optional, for db-tools)

## Run

```bash
npm start
```

## Project Structure

```
src/
  index.ts           # MCP server entry point
  litefarm-client.ts # API client
  types.ts           # TypeScript types
  tools/             # MCP tool implementations
    animal-tools.ts
    crop-tools.ts
    db-tools.ts
    farm-tools.ts
    finance-tools.ts
    location-tools.ts
    task-tools.ts
scripts/             # Utility scripts
docs/                # Documentation
```

## MCP Integration

Add to your Claude Code MCP config:

```json
{
  "mcpServers": {
    "litefarm": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/Litefarm-mcp-server"
    }
  }
}
```