Buddai MCP Servers

Folder containing the MCP servers that power Buddai. Each service exposes specific tools through the Model Context Protocol and is typically packaged into its own Docker image defined in *.mcp.yml files.

Image building

• The docker-compose.yml in this directory groups the build recipes to rebuild all images at once (docker compose build). It is meant as a local shortcut: it does not start running containers; it only facilitates consistent compilation of each service.

Active servers

• Agenda (agenda/) – Node.js server wrapping the agenda library to schedule, snooze, and list reminders in MongoDB. README

• Apple Calendar (calendarTool/) – Syncs an iCloud/CalDAV calendar into MongoDB, generates local embeddings, and allows searching/creating events. README

• Google Maps (drive/) – Python service with routing and geocoding utilities backed by the Google Maps API. README

• User Location (location/) – Saves and retrieves the user’s current location in MongoDB via a lightweight Node.js MCP. README

• Notes & Docs (notes/) – Stores notes with embeddings (nomic-embed-text-v1.5) to enable semantic searches. README

• Web Scraper (scraper/) – Extracts content from websites, Instagram, and YouTube, normalizes it, and indexes it with embeddings for later queries. README

• Supervisor (supervisor/) – Hybrid FastAPI + FastMCP service that coordinates LangGraph agents and MCP tools, exposing run_supervisor. README

• Time Utilities (time/) – Python server providing current time, conversion, and difference calculations. README

• Weather (weather/) – Wraps the Open-Meteo API to obtain daily weather forecasts. README

Prototypes and legacy

• Deprecated (deprecated/) – Contains old or experimental implementations, such as the legacy Apple Calendar and the progress_tests prototype. README