SABIS MCP Server

AModel Context Protocol (MCP) Serverfor accessing academic grades from theSakarya University SABIS(Student Information System). This server enables AI assistants and applications to securely retrieve student academic information through automated web scraping.

- 🔐 Secure Authentication: Uses environment variables for credentials
- 📊 Comprehensive Grade Retrieval: Fetches detailed academic information including:

- Course codes and names
- Assessment types (Midterm, Quiz, Assignments, Projects, Finals)
- Grade percentages and weights
- Final letter grades
- Academic year and semester information

- TypeScript- Type-safe development
- Puppeteer- Web scraping and browser automation
- Model Context Protocol SDK- MCP server implementation
- Node.js- Runtime environment

- Node.js 18+
- TypeScript 5.8+
- Valid SABIS credentials (Sakarya University student account)

git clone https://github.com/your-username/sabis-mcp-server.git cd sabis-mcp-server

Set up environment variables:Create a.envfile in the root directory:

USERNAME=your_sabis_username PASSWORD=your_sabis_password

You have two options for configuring credentials with your MCP client:

Option 1: Environment Variables in MCP Configuration

Add the server to your MCP client configuration with credentials directly in the config:

{ "mcpServers": { "sabis-mcp-server": { "command": "node", "args": [ "/path/to/sabis-mcp-server/build/index.js" ], "env": { "USERNAME": "your_student_number", "PASSWORD": "your_password" } } } }

Alternatively, create a.envfile in the project directory and remove theenvproperty from the MCP configuration:

USERNAME=your_student_number PASSWORD=your_password

{ "mcpServers": { "sabis-mcp-server": { "command": "node", "args": [ "/path/to/sabis-mcp-server/build/index.js" ] } } }

💡 Tip: Option 1 is more convenient for MCP clients like Cursor, while Option 2 is better for keeping credentials separate from configuration files.

Once configured, you can use the MCP server with compatible AI assistants:

Retrieves academic grades from SABIS system.

// Through MCP-enabled AI assistant "Get my grades from SABIS"

Login successful! 🎓 Academic Year: 2024 - Semester: Bahar === SWE310 - MOBİL UYGULAMA GELİŞTİRME === Grup: 1. Öğretim A Grubu • Ara Sınav (45%): 95 • Ödev (5%): 100 • Final (50%): 85 📋 Final Grade: AA

# Install dependencies npm install # Build the project npm run build # Test the server node build/index.js

sabis-mcp-server/ ├── src/ │ └── index.ts # Main MCP server implementation ├── build/ # Compiled JavaScript output ├── package.json # Dependencies and scripts ├── tsconfig.json # TypeScript configuration └── README.md # This file

- MCP Server Setup: Configured using@modelcontextprotocol/sdk
- Authentication: Environment-based credential management
- Web Scraping: Puppeteer-based automation for SABIS portal
- Data Extraction: DOM parsing for grade information
- Error Handling: Comprehensive error management and logging

- Credentials: Stored securely in environment variables
- Headless Operation: No UI exposure of sensitive information
- HTTPS: All communication with SABIS uses secure connections
- No Data Storage: Grades are fetched in real-time, not stored locally
- Session Management: Browser sessions are properly cleaned up

"Username and password are required"

- Ensure environment variablesUSERNAMEandPASSWORDare set
- Check.envfile exists and contains correct credentials

- Verify SABIS credentials are correct
- Check if SABIS portal is accessible
- Ensure university network access if required

- Install Chromium dependencies on Linux:

sudo apt-get install -y libgbm-dev libnss3-dev libxss1 libasound2

Authenticates with SABIS and retrieves academic grade information.

Parameters:None (uses environment variables)

- Academic year and semester
- Course information with grades
- Assessment breakdown with percentages
- Final grades where available
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

This project is licensed under the ISC License - see theLICENSEfile for details.

- Model Context Protocol- Official MCP documentation
- Puppeteer- Browser automation library
- Claude MCP Integration- Using MCP with Claude

Official Playwright MCP server for browser automation, page inspection, screenshots, and web interaction from Claude, Cursor, and other AI agents.