🌳 Urban Forestry Model Context Protocol (MCP) Server

Un servidor municipal de Model Context Protocol (MCP) para la silvicultura urbana, la gestión de inventarios de árboles, las métricas de Tree Canopy Assessment (TCA), las comunicaciones con residentes, las órdenes de trabajo y el análisis de límites GIS.

🚀 Características y conjuntos de datos

• Tree Sites (más de 17,700 registros): Buscar el stock público de árboles por especie, condición (0–5), calle, dirección, riesgo o estado de mantenimiento.

• Tree Activities (más de 11,600 registros): Historial completo de órdenes de trabajo (poda cíclica, eliminaciones, plantaciones, inspecciones).

• Historical Annual Tree Log: Seguimiento del crecimiento del DBH año tras año y cambios de condición (Original_GlobalID <-> GlobalID).

• Master Taxonomy Roster (731 especies): Catálogo autoritativo para tamaños maduros, tasa de crecimiento, estado nativo y aprobaciones de árboles de calle.

• Tree Canopy Assessment (TCA 2025): Porcentaje real de cobertura de dosel aéreo y métricas de acres en toda la ciudad, por distrito, zonificación, subdivisión, uso del suelo o parque.

• Forestry Contacts & Communications (solo lectura): Solicitudes de residentes, advertencias de seguridad y registros completos de interacción con coincidencia flexible de direcciones.

• Forestry Tasks: Asignaciones de trabajo en tiempo real y seguimiento de estado.

• Subdivisions & Parcels: Consultas espaciales para desarrollos y datos de dosel específicos de parcelas.

Related MCP server: ArcGIS MCP

🛠️ Las 15 herramientas MCP

1. search_trees - Buscar el stock público de árboles por especie, calle, dirección, condición o riesgo.

2. get_tree_details - Detalles completos del sitio del árbol con actividades, número de instantáneas y contactos con coincidencia flexible.

3. get_tree_activities - Historial cronológico de mantenimiento/inspección de un árbol.

4. get_tree_history - Registros de instantáneas anuales que rastrean los atributos del árbol a lo largo del tiempo.

5. search_trees_by_location - Búsqueda de proximidad dentro de un radio en PIES o cuadro delimitador.

6. get_tree_statistics - Agrupación y agregación del lado del servidor en todo el inventario de árboles.

7. get_activity_statistics - Agrupación del lado del servidor en todas las órdenes de trabajo.

8. get_urban_forest_health_report - Informe completo de salud, diversidad 10-20-30, condición y riesgo.

9. get_tree_canopy_metrics - Porcentaje real de cobertura de dosel arbóreo TCA y métricas de acres.

10. search_taxonomy_roster - Búsqueda en el catálogo maestro de taxonomía de 731 especies.

11. get_subdivision_profile - Perfil de stock de árboles de la subdivisión y cobertura de dosel aéreo.

12. search_parcels - Búsqueda por número/parcela o dirección con % de dosel de parcela y coincidencia flexible de árboles.

13. search_forestry_contacts - Detalles de contacto de residentes, solicitudes de plantación y registros de comunicación.

14. search_forestry_tasks - Asignaciones de trabajo por asignado, estado, prioridad o tipo de tarea.

15. get_recent_updates - Seguimiento en tiempo real de ediciones y adiciones en los últimos N días.

🏃 Inicio rápido local

1. Instalar requisitos

pip install -r requirements.txt

2. Verificar herramientas

python test_tools.py

3. Ejecutar localmente (modo stdio para Antigravity / Claude Desktop)

python server.py --transport stdio

4. Ejecutar localmente (modo SSE en el puerto 8000 para LibreChat / Web)

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

🐳 Despliegue con Docker (para alojamiento en campo / nube)

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

El endpoint SSE estará disponible en http://<your-server-ip>:8000/sse.

📱 Conexión de clientes de campo (LibreChat / Móvil)

Añade a tu librechat.yaml:

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