Skip to main content
Glama
Scrum723

Doc AI

by Scrum723
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Doc AI

Conversational weather agent for the Amazon Developer Hackathon — Alexa+ track only.

Doc AI absorbs public weather APIs plus simulated IoT sensors, stores normalized readings in SQLite, and exposes them through a self-hosted MCP server (spec 2025-11-25, Streamable HTTP) so Alexa+ can talk about current conditions, forecasts, alerts, and history in short spoken sentences.

This is not a rename of DOC Watch dock-advice tools. Doc AI is a first-release ingest/store/chat product with historical + IoT + chat_summary.

One-command start

cd doc-ai
npm install
npm run dev

Then:

Tests: npm test

Related MCP server: MCP Weather Server

MCP tools

Tool

What it does

get_current_weather

Live Open-Meteo (seed fallback)

get_forecast

Daily forecast, days default 7

get_alerts

NWS api.weather.gov alerts (seed fallback)

get_historical

Date-range query against stored readings

list_iot_sources

Simulated IoT nodes

chat_summary

Spoken briefing, no markdown

Data layer

  • Open-Meteo api.open-meteo.com + archive archive-api.open-meteo.com

  • NWS api.weather.gov

  • Simulated IoT probes (labeled simulation — not a live worldwide camera mesh)

  • SQLite (data/doc-ai.sqlite) seeded from data/seed.json so the demo works offline

Folders

server/     MCP Streamable HTTP entry (POST + GET /mcp, Origin 403)
data/       ingest, normalize, SQLite, seed, IoT sim
agent/      voice formatter + tool orchestrator
deploy/     Dockerfile companion, App Runner script
docs/       product-feedback, friction log, Devpost paste, demo script
web/        simulated Alexa+ chat

Deploy (AWS App Runner)

docker build -t doc-ai .
# or
bash deploy/deploy-apprunner.sh

Request AWS Builder credits if needed. Localhost bind is the default for the 3-minute demo.

License

MIT. Public GitHub intended: https://github.com/Scrum723/doc-ai

If submitting private instead, share with testing@devpost.com and Amazon reviewers: chris-trag, knmeiss, giolaq, anishamalde, mosesroth, emersonsklar.

Prior work

DOC / WFAD / SWAFT / DOC Watch are related weather-agent lineage. Doc AI is a new ingest-store-MCP surface (historical, IoT list, chat_summary, two-API SQLite), not a reskin of the locked DOC Watch dock-tool list.

Primary track: Alexa+ only.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Weather App MCP Server

    jenniferjiang0511
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to get weather alerts and forecasts for U.S. locations using the National Weather Service API, with support for natural language queries including fun conversational tones.
    MIT

  • MCP Weather Server

    kumaran-is
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time weather information and multi-day forecasts using the Open-Meteo API through a robust, enterprise-grade architecture. It enables AI assistants to retrieve current conditions, 7-day forecasts, and contextual weather data for any location.
    7 npm
    MIT

  • Athena Weather MCP

    zordhalo
    F
    license
    Not graded
    quality
    B
    maintenance
    Exposes live weather data from Open-Meteo and NWS, providing tools to explore forecasts and list active severe weather alerts. It renders an embedded interactive widget for the Athena platform, with no API keys required.
    -