convez.ai
MCP Server
poplores

umd-schedule-mcp

poplores/umd-schedule-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

Python MCP server that exposes my UMD class schedule to Claude via SQLite

Instalação

$npx convez-ai poplores/umd-schedule-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

umd-schedule-mcp

Python MCP server that exposes my UMD class schedule to Claude via SQLite.

Overview

Reads a class schedule from schedule.yaml, loads it into a local SQLite database (schedule.db), and serves it over the Model Context Protocol. Any MCP client (Claude Code, MCP Inspector, etc.) can then query the schedule with natural language.

Tools

ToolDescription
get_classes_todayAll meetings scheduled for today, sorted by start time. Empty on weekends/no classes.
get_next_classThe next meeting from right now. Counts a class in session as "next"; rolls forward to the next day with classes if nothing's left today.
get_classes_for_dayAll meetings for a given day. Accepts M, T, W, Th, F or full names like Monday (case-insensitive).
find_classAll meetings for a course by code or substring (e.g. CMSC 131, chem). Case-insensitive.

Requirements

  • Python 3.9+ (uses zoneinfo)
  • mcp>=1.0.0, pyyaml>=6.0

Setup

git clone https://github.com/poplores/umd-schedule-mcp.git
cd umd-schedule-mcp

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate

pip install -r requirements.txt

Loading the schedule

Edit schedule.yaml with your courses, then build the database:

python load_schedule.py

This creates schedule.db. Re-run it whenever you change schedule.yaml.

Running the server

python server.py

The server uses stdio transport by default.

Connecting to Claude Code

claude mcp add umd-schedule -- python /absolute/path/to/server.py

Then ask things like "What classes do I have today?" or "When does my chem class meet?"

Files

FilePurpose
schedule.yamlSource of truth for course data
load_schedule.pyLoads YAML into SQLite (schedule.db)
server.pyMCP server exposing the four schedule tools
requirements.txtPython dependencies
Ver o original no GitHub

Bom para

Relacionados