@driftwest/mcp-server 1.1.1

package/index.js

@@ -0,0 +1,485 @@
+#!/usr/bin/env node
+/**
+ * DriftWest MCP Server
+ *
+ * Provides 21 environmental datasets to AI agents via Model Context Protocol.
+ * Connects to the DriftWest.XYZ API for real-time EMF sensor data, space weather,
+ * coastal environmental indices for 355 beaches, wildfire monitoring, air quality,
+ * and seismic activity.
+ *
+ * Usage with Claude Desktop:
+ *   Add to claude_desktop_config.json:
+ *   {
+ *     "mcpServers": {
+ *       "driftwest": {
+ *         "command": "npx",
+ *         "args": ["@driftwest/mcp-server"],
+ *         "env": { "DRIFTWEST_API_KEY": "dw_your_key" }
+ *       }
+ *     }
+ *   }
+ */
+
+const { McpServer } = require('@modelcontextprotocol/sdk/server/mcp.js');
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const { z } = require('zod');
+
+const BASE_URL = process.env.DRIFTWEST_BASE_URL || 'https://driftwest.xyz';
+const API_KEY = process.env.DRIFTWEST_API_KEY || '';
+
+async function apiCall(path, options = {}) {
+  const url = `${BASE_URL}${path}`;
+  const headers = { 'Content-Type': 'application/json' };
+  if (API_KEY) headers['X-API-Key'] = API_KEY;
+
+  const res = await fetch(url, { ...options, headers: { ...headers, ...options.headers } });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`API error ${res.status}: ${text}`);
+  }
+  return res.json();
+}
+
+const server = new McpServer({
+  name: 'driftwest',
+  version: '1.0.0',
+  description: 'DriftWest Environmental Data — EMF sensors, space weather, coastal environment, wildfire monitoring, air quality, and seismic activity'
+});
+
+// ── EMF Sensor Tools ──
+
+server.tool(
+  'emf_latest',
+  'Get the latest reading from an EMF sensor node. Available nodes: NodeAir1 (air EMF), NodeStem1 (plant stem mV), NodeRoot1 (plant root mV), NodeSoil1 (soil EMF), HouseMonitor-Temp (°C), HouseMonitor-Humidity (%), GOES-Xray (W/m²), GOES-Proton (particles/cm²/s/sr)',
+  { nodeId: z.string().describe('Sensor node ID, e.g. NodeAir1, GOES-Xray') },
+  async ({ nodeId }) => {
+    const data = await apiCall(`/api/data/latest/${encodeURIComponent(nodeId)}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'emf_stats',
+  'Get 24-hour statistics (min, max, mean, count) for all EMF sensor nodes',
+  {},
+  async () => {
+    const data = await apiCall('/api/stats/ranges');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'emf_history',
+  'Get historical time-series readings from a sensor node',
+  {
+    nodeId: z.string().describe('Sensor node ID'),
+    hours: z.number().optional().default(6).describe('Hours of history (default 6)')
+  },
+  async ({ nodeId, hours }) => {
+    const start = Date.now() - hours * 3600000;
+    const data = await apiCall(`/api/data/${encodeURIComponent(nodeId)}?start=${start}&limit=500`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'sensor_nodes',
+  'List all sensor nodes with their current online/offline status',
+  {},
+  async () => {
+    const data = await apiCall('/api/nodes');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Space Weather Tools ──
+
+server.tool(
+  'space_weather',
+  'Get current space weather conditions: Kp/Dst indices, solar wind, GOES flux, composite disturbance score (0-100)',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/space-weather/current');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'space_weather_alerts',
+  'Get active NOAA space weather alerts (geomagnetic storms, solar flares, radiation storms)',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/space-weather/alerts');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Beach & Coastal Tools ──
+
+server.tool(
+  'search_beaches',
+  'Search for beaches by location, province, or water type. Returns profiles with water quality, biodiversity, recreation, and risk indices.',
+  {
+    lat: z.number().optional().describe('Latitude for proximity search'),
+    lon: z.number().optional().describe('Longitude for proximity search'),
+    radius: z.number().optional().default(50).describe('Search radius in km'),
+    province: z.string().optional().describe('Province filter: British Columbia, Alberta, Oregon'),
+    type: z.string().optional().describe('Water type: tidal, lake, river'),
+    limit: z.number().optional().default(20).describe('Max results')
+  },
+  async ({ lat, lon, radius, province, type, limit }) => {
+    const params = new URLSearchParams();
+    if (lat !== undefined) params.set('lat', lat);
+    if (lon !== undefined) params.set('lon', lon);
+    if (radius) params.set('radius', radius);
+    if (province) params.set('province', province);
+    if (type) params.set('type', type);
+    if (limit) params.set('limit', limit);
+    const data = await apiCall(`/api/datasets/coastal-atlas/search?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'beach_detail',
+  'Get complete beach dossier: all indices, satellite data, community metrics, descriptions, and environmental analysis',
+  { id: z.string().describe('Beach ID') },
+  async ({ id }) => {
+    const data = await apiCall(`/api/datasets/coastal-atlas/beach/${encodeURIComponent(id)}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'nearby_beaches',
+  'Find beaches near a location sorted by recreation score. Great for trip planning.',
+  {
+    lat: z.number().describe('Latitude'),
+    lon: z.number().describe('Longitude'),
+    radius: z.number().optional().default(30).describe('Radius in km')
+  },
+  async ({ lat, lon, radius }) => {
+    const data = await apiCall(`/api/datasets/recreation/nearby?lat=${lat}&lon=${lon}&radius=${radius}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'water_quality_rankings',
+  'Get beaches ranked by water quality index (0-100). Filterable by province and water type.',
+  {
+    province: z.string().optional(),
+    type: z.string().optional().describe('tidal, lake, river'),
+    limit: z.number().optional().default(20)
+  },
+  async ({ province, type, limit }) => {
+    const params = new URLSearchParams();
+    if (province) params.set('province', province);
+    if (type) params.set('type', type);
+    if (limit) params.set('limit', limit);
+    const data = await apiCall(`/api/datasets/water-quality/rankings?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'water_quality_summary',
+  'Aggregate water quality statistics by province and water type across all 355 beaches',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/water-quality/summary');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'biodiversity_hotspots',
+  'Top biodiversity hotspots: beaches with highest fauna and flora richness',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/biodiversity/hotspots');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'shoreline_risk_alerts',
+  'Active environmental risk alerts: beaches with high algae bloom risk, erosion, or human pressure',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/shoreline-risk/alerts');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'compare_beaches',
+  'Compare up to 10 beaches side-by-side across all indices with automatic winner identification',
+  { ids: z.string().describe('Comma-separated beach IDs, e.g. "beach1,beach2,beach3"') },
+  async ({ ids }) => {
+    const data = await apiCall(`/api/datasets/beach-compare?ids=${encodeURIComponent(ids)}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'algae_risk',
+  'Algae bloom risk analysis: high/medium/low breakdown with chlorophyll and cyanobacteria data',
+  {
+    province: z.string().optional(),
+    type: z.string().optional().describe('tidal, lake, river')
+  },
+  async ({ province, type }) => {
+    const params = new URLSearchParams();
+    if (province) params.set('province', province);
+    if (type) params.set('type', type);
+    const data = await apiCall(`/api/datasets/water-trends/algae-risk?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Wildfire Tools ──
+
+server.tool(
+  'wildfire_current',
+  'Get current Canadian wildfire conditions: active fire count, national danger rating (Low to Extreme), city fire proximity scores, and province breakdown',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/wildfire/current');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'wildfire_hotspots',
+  'Get active fire hotspot locations with brightness, fire radiative power, and confidence from NASA FIRMS satellite detection',
+  {
+    province: z.string().optional().describe('Province code: BC, AB, SK, MB, ON, QC'),
+    minConfidence: z.string().optional().describe('Filter: low, nominal, high'),
+    limit: z.number().optional().default(200)
+  },
+  async ({ province, minConfidence, limit }) => {
+    const params = new URLSearchParams();
+    if (province) params.set('province', province);
+    if (minConfidence) params.set('minConfidence', minConfidence);
+    if (limit) params.set('limit', limit);
+    const data = await apiCall(`/api/datasets/wildfire/hotspots?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'wildfire_smoke_impact',
+  'Get per-city smoke impact with AQI, PM2.5, and fire proximity score for 10 Canadian cities',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/wildfire/smoke-impact');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Air Quality Tools ──
+
+server.tool(
+  'air_quality_current',
+  'Get current air quality for 12 cities (Calgary, Edmonton, Vancouver, Toronto, Montreal, Ottawa, Winnipeg, Saskatoon, Victoria, Halifax, Portland, Seattle). Includes AQI, health risk score (0-100), and safety rating.',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/air-quality/current');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'air_quality_city',
+  'Get detailed air quality for one city: full pollutant breakdown (PM2.5, O3, NO2, PM10, SO2, CO), UV index, health risk score, and recommendations',
+  { cityId: z.string().describe('City ID: calgary, edmonton, vancouver, toronto, montreal, ottawa, winnipeg, saskatoon, victoria, halifax, portland, seattle') },
+  async ({ cityId }) => {
+    const data = await apiCall(`/api/datasets/air-quality/city/${encodeURIComponent(cityId)}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'air_quality_rankings',
+  'Get cities ranked by health risk score (lowest = best air quality)',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/air-quality/rankings');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'air_quality_alerts',
+  'Get cities currently exceeding AQI 100 (unhealthy for sensitive groups) with PM2.5 values and health recommendations',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/air-quality/alerts');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Seismic Tools ──
+
+server.tool(
+  'seismic_recent',
+  'Get recent global earthquakes (M2.5+) from USGS sorted by time',
+  {
+    days: z.number().optional().default(1).describe('Days of history (max 30)'),
+    minMagnitude: z.number().optional().default(2.5),
+    limit: z.number().optional().default(100)
+  },
+  async ({ days, minMagnitude, limit }) => {
+    const params = new URLSearchParams();
+    if (days) params.set('days', days);
+    if (minMagnitude) params.set('minMagnitude', minMagnitude);
+    if (limit) params.set('limit', limit);
+    const data = await apiCall(`/api/datasets/seismic/recent?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'seismic_canada',
+  'Get Canadian earthquakes only (M1.0+) with comprehensive coverage',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/seismic/canada');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'seismic_activity_score',
+  'Get seismic activity scores (0-100) for 5 Canadian risk zones: BC Coast (Cascadia Subduction), St. Lawrence, Ottawa-Gatineau, Alberta (induced seismicity), Arctic. Includes population exposure analysis.',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/seismic/activity-score');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  'seismic_nearby',
+  'Find earthquakes near a geographic point sorted by distance',
+  {
+    lat: z.number().describe('Latitude'),
+    lon: z.number().describe('Longitude'),
+    radius: z.number().optional().default(200).describe('Search radius in km (max 1000)')
+  },
+  async ({ lat, lon, radius }) => {
+    const data = await apiCall(`/api/datasets/seismic/nearby?lat=${lat}&lon=${lon}&radius=${radius}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Cross-Domain Tools ──
+
+server.tool(
+  'alberta_environment',
+  'Alberta environmental dashboard: combines EMF sensors, water quality for 56 water bodies, space weather, and algae risk',
+  {},
+  async () => {
+    const data = await apiCall('/api/datasets/alberta-environment/current');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Agent Decision Support Tools ──
+
+server.tool(
+  'safety_check',
+  'Composite environmental safety assessment for a location. Returns go/no-go verdict combining air quality, wildfire proximity, and seismic activity. Designed for autonomous agents making location-dependent decisions.',
+  {
+    lat: z.number().describe('Latitude of location to assess'),
+    lon: z.number().describe('Longitude of location to assess')
+  },
+  async ({ lat, lon }) => {
+    const data = await apiCall(`/api/datasets/safety-check?lat=${lat}&lon=${lon}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// ── Resources ──
+
+server.resource(
+  'emf-overview',
+  'driftwest://emf/overview',
+  { description: 'Overview of all EMF sensor nodes and their current readings', mimeType: 'application/json' },
+  async () => {
+    const [nodes, stats] = await Promise.all([
+      apiCall('/api/nodes'),
+      apiCall('/api/stats/ranges')
+    ]);
+    return {
+      contents: [{
+        uri: 'driftwest://emf/overview',
+        text: JSON.stringify({ nodes: nodes.nodes, stats24h: stats.ranges }, null, 2),
+        mimeType: 'application/json'
+      }]
+    };
+  }
+);
+
+server.resource(
+  'dataset-catalog',
+  'driftwest://datasets/catalog',
+  { description: 'Complete catalog of all 21 DriftWest datasets with descriptions and endpoints', mimeType: 'text/plain' },
+  async () => {
+    return {
+      contents: [{
+        uri: 'driftwest://datasets/catalog',
+        text: `DriftWest Dataset Catalog (21 datasets)
+
+EMF & Space Weather (8):
+  prairie-emf-live — Real-time EMF from 3 ESP32 EMF nodes + 1 house monitor (Strathmore, AB)
+  space-weather-dashboard — GOES flux, Kp/Dst, solar wind, disturbance score
+  emf-weather-correlations — Daily EMF vs weather/lunar/seismic analysis
+  satellite-rf-exposure — RF power density from satellite passes
+  agricultural-emf-index — EMF for precision agriculture
+  emf-anomaly-stream — Z-score anomaly detection on EMF data
+  solar-flare-alerts — GOES X-ray classification
+  geomagnetic-storm-index — Kp tracking with G-scale classification
+
+Environment Monitoring (3):
+  canadian-wildfire — NASA FIRMS fire hotspots, smoke impact, danger rating (15-min refresh)
+  air-quality-health — Respiratory health risk for 12 cities, 6 pollutants (15-min refresh)
+  seismic-monitor — USGS earthquakes, 5 Canadian risk zone scores (5-min refresh)
+
+Cross-Domain (3):
+  alberta-environment — EMF + 56 Alberta water bodies + space weather
+  beach-compare — Side-by-side comparison of up to 10 beaches
+  water-trends — Provincial statistics, temperature, algae risk
+
+Agent Decision Support (1):
+  safety-check — Composite go/no-go verdict combining air quality, wildfire proximity, and seismic activity
+
+Coastal Environment (5, 355 beaches):
+  pnw-water-quality — Water Quality Index (0-100) from satellite data
+  coastal-biodiversity — Fauna/flora richness, habitat complexity
+  beach-recreation — Recreation score with spatial proximity search
+  shoreline-risk — Multi-factor environmental risk with alerts
+  bc-coastal-atlas — Geographic discovery API with all indices
+
+Use tools like search_beaches, water_quality_rankings, space_weather, emf_latest,
+wildfire_current, air_quality_current, seismic_recent to query data.
+All dataset tools require an API key (set DRIFTWEST_API_KEY env var).
+Free keys: POST https://driftwest.xyz/api/account/register with {"email":"..."}`,
+        mimeType: 'text/plain'
+      }]
+    };
+  }
+);
+
+// ── Start Server ──
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(err => {
+  console.error('MCP server error:', err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@driftwest/mcp-server",
+  "version": "1.1.1",
+  "description": "MCP server for DriftWest environmental data — 28 tools: EMF sensors, space weather, 355 beaches, wildfire monitoring, air quality, and seismic activity. Free tier + $29/mo researcher.",
+  "main": "index.js",
+  "bin": {
+    "driftwest-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "environmental-data",
+    "emf",
+    "space-weather",
+    "beaches",
+    "water-quality",
+    "wildfire",
+    "air-quality",
+    "earthquake",
+    "seismic",
+    "ai-agent",
+    "claude",
+    "ai-tools"
+  ],
+  "author": "DriftWest Labs <info@driftwest.xyz>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/driftwest/mcp-server"
+  },
+  "homepage": "https://driftwest.xyz",
+  "mcpName": "driftwest/mcp-server",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}