# 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"
}
}
}
```
