UofT Student Helper MCP Server

# Quick Start Guide 🚀 Get your UofT Student Helper MCP server running in 5 minutes! ## Prerequisites - Python 3.9+ - UofT student account - Cohere North MCP Python SDK (installed) ## Step 1: Setup (2 minutes) ```bash # Clone or navigate to the project cd uoft-student-helper-mcp # Install dependencies pip install -r requirements.txt # Copy environment template cp .env.example .env # Edit .env with your credentials # Use your favorite text editor (nano, vim, code, etc.) nano .env ``` ## Step 2: Configure Credentials (2 minutes) Edit `.env` and add: ```bash ACORN_USERNAME=your_utorid ACORN_PASSWORD=your_password QUERCUS_API_TOKEN=your_token_here SERVER_PORT=3002 ``` ### How to get Quercus API Token: 1. Go to https://q.utoronto.ca/ 2. Click on "Account" → "Settings" 3. Scroll to "Approved Integrations" 4. Click "+ New Access Token" 5. Purpose: "MCP Server" 6. Click "Generate Token" 7. Copy and paste into `.env` ## Step 3: Run (1 minute) ```bash # Start the server python uoft_student_helper.py ``` You should see: ``` ✅ ACORN client initialized ✅ Quercus client initialized Starting server on port 3002... INFO: Uvicorn running on http://0.0.0.0:3002 ``` ## Step 4: Test Open a new terminal: ```bash # Test health curl http://localhost:3002/health # Test getting courses curl -X POST http://localhost:3002/call \ -H "Content-Type: application/json" \ -d '{"tool": "get_enrolled_courses", "arguments": {}}' # Or use the test script python test_server.py ``` ## Step 5: Expose with ngrok (Optional) ```bash # In a new terminal ngrok http 3002 ``` Copy the HTTPS URL to use with Cohere North! ## Troubleshooting ### "Module not found: north_mcp_python_sdk" Install the SDK: ```bash cd path/to/north-mcp-python-sdk pip install -e . ``` ### "ACORN/Quercus client not initialized" Check your `.env` file has correct credentials. ### Port already in use Change `SERVER_PORT` in `.env` to a different port (e.g., 3003). ## Next Steps - Read the full [README.md](README.md) - Connect to Cohere North - Customize the tools for your needs ## Need Help? - Check [README.md](README.md) for detailed documentation - Open an issue on GitHub - Contact the maintainers --- **Ready to go!** Your UofT Student Helper is now running! 🎓