student-progress-tracker CLAUDE.md

Student Progress Tracker MCP Server

Tech Stack

• Language: Python 3.12
• Framework: FastMCP (Model Context Protocol SDK)
• Database: SQLite3 (local file: data/student_progress.db, configurable via STUDENT_PROGRESS_DB env var)
• Dependencies: mcp>=1.0.0, python-dateutil>=2.8.0

Project Structure

student-progress-tracker/
├── run_server.py                  # MCP server entry point (stdio transport)
├── src/
│   └── student_progress/
│       ├── __init__.py
│       ├── __main__.py            # Alternate entry: python -m src.student_progress
│       ├── server.py              # MCP tool definitions (21 tools)
│       ├── database.py            # SQLite schema + queries (10 tables)
│       └── validators.py          # Input validation functions
├── tests/
│   ├── test_database.py           # Database unit tests (57 tests)
│   ├── test_server.py             # Server tool tests (81 tests)
│   └── test_validators.py         # Validator unit tests (38 tests)
├── data/
│   └── student_progress.db        # SQLite database (auto-created, gitignored)
├── requirements.txt
└── pyproject.toml                 # Linting config (ruff)

Running the Server

# Activate virtualenv
source venv/bin/activate

# Run directly
python run_server.py

# Or as a module
python -m src.student_progress

# Custom database path
STUDENT_PROGRESS_DB=/path/to/db.sqlite python run_server.py

Connecting to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "student-progress": {
      "command": "/path/to/student-progress-tracker/venv/bin/python",
      "args": ["/path/to/student-progress-tracker/run_server.py"]
    }
  }
}

Connecting to Claude Code

Add to .claude/settings.json or project's .mcp.json:

{
  "mcpServers": {
    "student-progress": {
      "command": "/path/to/student-progress-tracker/venv/bin/python",
      "args": ["/path/to/student-progress-tracker/run_server.py"]
    }
  }
}