How jake-herrera/weather-station-backend works
This backend receives weather readings from an ESP32, validates and timestamps them, stores them in Firebase, and serves readings through REST and MCP tools. The graph separates HTTP handling, MCP access, domain helpers, and persistence. The MCP tool-to-database links are supported by the source index; unsampled tool internals are not described beyond those references.
Main entry points: firebase.ts Firebase Data Access · index.ts Express App · server.ts MCP Server · data.ts Reading Ingestion
Components 18
REST API
- Express App
src/index.ts - Reading Ingestion
src/routes/data.ts - Reading Queries
src/routes/readings.ts
MCP API
- MCP Transport
src/mcp/transport.ts - MCP Server
src/mcp/server.ts - Latest Tool
src/mcp/tools/get-latest-reading.ts - Range Tool
src/mcp/tools/get-readings-in-range.ts - Statistics Tool
src/mcp/tools/get-stats-for-range.ts - Device Metadata Tool
src/mcp/tools/get-device-meta.ts
Reading Domain
- Reading Validation
src/services/validate-reading.ts - Reading Schema
src/types/reading.ts - Time Range Helpers
src/services/time-range.ts - DNS Configuration
src/config/dns.ts
Persistence
- Firebase Data Access
src/db/firebase.ts - Firebase Realtime DB
Other components
- ESP32 Station
- REST Client
- AI Assistant
Connections 23
- ESP32 Station → Express App: sends readings
README.md - REST Client → Express App: requests REST
README.md - AI Assistant → MCP Transport: sends MCP requests
README.md - Express App → DNS Configuration: configures DNS
src/index.ts - Express App → Reading Ingestion: mounts route
src/index.ts - Express App → Reading Queries: mounts route
src/index.ts - Express App → MCP Transport: mounts route
src/index.ts - Express App → Firebase Data Access: initializes
src/index.ts - Reading Ingestion → Reading Validation: validates payload
src/routes/data.ts - Reading Validation → Reading Schema: parses against
src/services/validate-reading.ts - Reading Ingestion → Firebase Data Access: saves reading
src/routes/data.ts - Reading Queries → Time Range Helpers: validates and computes range
src/routes/readings.ts - Reading Queries → Firebase Data Access: fetches readings
src/routes/readings.ts - MCP Transport → MCP Server: creates server
src/mcp/transport.ts - MCP Server → Latest Tool: registers tool
src/mcp/server.ts - MCP Server → Range Tool: registers tool
src/mcp/server.ts - MCP Server → Statistics Tool: registers tool
src/mcp/server.ts - MCP Server → Device Metadata Tool: registers tool
src/mcp/server.ts - Latest Tool → Firebase Data Access: reads latest
src/mcp/tools/get-latest-reading.ts - Range Tool → Firebase Data Access: reads range
src/mcp/tools/get-readings-in-range.ts - Statistics Tool → Firebase Data Access: fetches readings and metadata
src/mcp/tools/get-stats-for-range.ts - Device Metadata Tool → Firebase Data Access: reads metadata
src/mcp/tools/get-device-meta.ts - Firebase Data Access → Firebase Realtime DB: reads and writes
src/db/firebase.ts