🌳 도시 산림 Model Context Protocol (MCP) 서버

도시 산림, 수목 인벤토리 관리, 수관 평가(TCA) 지표, 주민 커뮤니케이션, 작업 지시 및 GIS 경계 분석을 위한 지방자치단체용 Model Context Protocol (MCP) 서버입니다.

🚀 기능 및 데이터셋

• 수목 위치 (17,700개 이상 레코드): 종, 상태(0–5), 도로, 주소, 위험도 또는 유지보수 상태별 공공 수목 재고 검색.

• 수목 활동 (11,600개 이상 레코드): 전체 작업 지시 이력(주기적 전지, 제거, 식재, 점검).

• 연간 수목 이력 로그: 연간 DBH 성장 및 상태 변화 추적(Original_GlobalID <-> GlobalID).

• 마스터 분류 목록 (731종): 성숙 크기, 성장 속도, 자생 여부 및 가로수 승인에 대한 공식 카탈로그.

• 수관 평가 (TCA 2025): 시 전체, 구, 용도지구, 구획, 토지 이용 또는 공원별 실제 항공 수관 피복 비율 및 에이커 지표.

• 산림 연락처 및 커뮤니케이션 (읽기 전용): 주민 요청, 안전 경고 및 유연한 주소 매칭이 포함된 전체 상호작용 로그.

• 산림 작업: 실시간 작업 배정 및 상태 추적.

• 구획 및 필지: 개발 및 필지별 수관 데이터에 대한 공간 쿼리.

Related MCP server: ArcGIS MCP

🛠️ 15가지 MCP 도구

1. search_trees - 종, 도로, 주소, 상태 또는 위험도별 공공 수목 재고 검색.

2. get_tree_details - 활동, 스냅샷 수 및 유연 매칭 연락처를 포함한 전체 수목 위치 상세 정보.

3. get_tree_activities - 수목의 연대순 유지보수/점검 이력.

4. get_tree_history - 시간 경과에 따른 수목 속성 추적을 위한 연간 스냅샷 로그.

5. search_trees_by_location - 피트 단위 반경 또는 경계 상자 내 근접 검색.

6. get_tree_statistics - 수목 인벤토리 전체에 대한 서버 측 그룹화 및 집계.

7. get_activity_statistics - 작업 지시 전체에 대한 서버 측 그룹화.

8. get_urban_forest_health_report - 전체 건강도, 10-20-30 다양성, 상태 및 위험도 보고서.

9. get_tree_canopy_metrics - 실제 TCA 수관 피복 % 및 에이커 지표.

10. search_taxonomy_roster - 마스터 731종 분류 카탈로그 검색.

11. get_subdivision_profile - 구획 수목 재고 및 항공 수관 피복 프로필.

12. search_parcels - 필지 수관 % 및 유연 수목 매칭이 포함된 필지 번호/주소 검색.

13. search_forestry_contacts - 주민 연락처 상세, 식재 요청 및 커뮤니케이션 로그.

14. search_forestry_tasks - 담당자, 상태, 우선순위 또는 작업 유형별 작업 배정.

15. get_recent_updates - 최근 N일간 편집 및 추가 사항 실시간 추적.

🏃 로컬 빠른 시작

1. 요구 사항 설치

pip install -r requirements.txt

2. 도구 확인

python test_tools.py

3. 로컬 실행 (Antigravity / Claude Desktop용 stdio 모드)

python server.py --transport stdio

4. 로컬 실행 (LibreChat / 웹용 포트 8000 SSE 모드)

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

🐳 Docker 배포 (현장 / 클라우드 호스팅용)

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

SSE 엔드포인트는 http://<your-server-ip>:8000/sse에서 사용할 수 있습니다.

📱 현장 클라이언트 연결 (LibreChat / 모바일)

librechat.yaml에 추가:

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