🌳 Urban Forestry Model Context Protocol (MCP) Server

A municipal Model Context Protocol (MCP) server for urban forestry, tree inventory management, Tree Canopy Assessment (TCA) metrics, resident communications, work orders, and GIS boundary analysis.

---

🚀 Features & Datasets

• Tree Sites (17,700+ records): Search public tree stock by species, condition (0–5), street, address, risk, or maintenance status.
• Tree Activities (11,600+ records): Full work order history (cycle pruning, removals, planting, inspections).
• Historical Annual Tree Log: Track year-over-year DBH growth and condition changes (Original_GlobalID <-> GlobalID).
• Master Taxonomy Roster (731 species): Authoritative catalog for mature sizes, growth rate, native status, and street tree approvals.
• Tree Canopy Assessment (TCA 2025): True aerial canopy coverage percentage and acre metrics citywide, by Ward, Zoning, Subdivision, Land Use, or Park.
• Forestry Contacts & Communications (Read-Only): Resident requests, safety warnings, and full interaction logs with soft address matching.
• Forestry Tasks: Real-time work assignments and status tracking.
• Subdivisions & Parcels: Spatial queries for developments and parcel-specific canopy data.

---

🛠️ The 15 MCP Tools

1. search_trees - Search public tree stock by species, street, address, condition, or risk.
2. get_tree_details - Complete tree site details with activities, snapshots count, and soft-matched contacts.
3. get_tree_activities - Chronological maintenance/inspection history for a tree.
4. get_tree_history - Annual snapshot logs tracking tree attributes over time.
5. search_trees_by_location - Proximity search within a radius in FEET or bounding box.
6. get_tree_statistics - Server-side grouping and aggregation across tree inventory.
7. get_activity_statistics - Server-side grouping across work orders.
8. get_urban_forest_health_report - Complete health, 10-20-30 diversity, condition, and risk report.
9. get_tree_canopy_metrics - True TCA tree canopy coverage % and acre metrics.
10. search_taxonomy_roster - Master 731-species taxonomy catalog search.
11. get_subdivision_profile - Subdivision tree stock and aerial canopy coverage profile.
12. search_parcels - Parcel number/address search with parcel canopy % and soft tree matching.
13. search_forestry_contacts - Resident contact details, planting requests, and communication logs.
14. search_forestry_tasks - Work assignments by assignee, status, priority, or task type.
15. get_recent_updates - Real-time tracking of edits and additions in the last N days.

---

🏃 Local Quickstart

1. Install Requirements

pip install -r requirements.txt

2. Verify Tools

python test_tools.py

3. Run Locally (stdio mode for Antigravity / Claude Desktop)

python server.py --transport stdio

4. Run Locally (SSE mode on port 8000 for LibreChat / Web)

python server.py --transport sse --host 0.0.0.0 --port 8000

---

🐳 Docker Deployment (For Field / Cloud Hosting)

# Build and start container in the background
docker-compose up -d --build

The SSE endpoint will be available at http://<your-server-ip>:8000/sse.

---

📱 Connecting Field Clients (LibreChat / Mobile)

Add to your librechat.yaml:

mcpServers:
  urban-forestry:
    type: sse
    url: http://<your-server-or-domain>:8000/sse