How do I use MCP Student Assistant?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Student Assistant What is Rahul's attendance?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Student Assistant

by Nishchitha98

Overview Schema Source Related Servers Discussions Admin

Python

Local

🎓 MCP Student Assistant

An AI-powered Student Assistant built with the Model Context Protocol (MCP). It exposes a set of student-focused tools — attendance lookup, marks calculator, notes search, college rules, and a math calculator — through an MCP server, with a companion CLI client powered by Groq's Llama 3.3 70B for natural-language interaction.

✨ Features

Tool	Description
Calculator	Evaluate arbitrary math expressions (e.g. `45*12+5`)
Attendance	Look up a student's attendance record from `attendance.csv`
Marks	Compute a student's average across Math, Physics, Chemistry, Java & Python
Notes Search	Search for keywords inside `notes.pdf`
College Rules	Display all college rules from `rules.txt`

For questions that don't match any tool, the client falls back to Groq's Llama 3.3 70B model for general-purpose answers.

Related MCP server: Personal Toolkit MCP Server

📁 Project Structure

MCP/
├── server.py          # MCP server — registers all tools
├── client.py          # CLI client — keyword routing + Groq fallback
├── attendance.py      # Attendance lookup (pandas + CSV)
├── marks.py           # Average marks calculator (pandas + CSV)
├── notes.py           # Keyword search across PDF notes
├── pdf_reader.py      # PDF text extraction (pypdf)
├── calculator.py      # Simple eval-based calculator
├── rules.py           # Reads college rules from a text file
├── requirements.txt   # Python dependencies
├── .env               # Environment variables (GROQ_API_KEY)
└── data/
    ├── attendance.csv  # Student attendance records
    ├── marks.csv       # Student marks (5 subjects)
    ├── notes.pdf       # Course notes (PDF)
    ├── notes.txt       # Course notes (plain text)
    ├── rules.txt       # College rules
    └── students.csv    # Student roster

🚀 Getting Started

Prerequisites

Python 3.10+
A Groq API key (free tier available)

1. Clone the repository

git clone <repo-url>
cd MCP

2. Create a virtual environment (recommended)

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

3. Install dependencies

pip install -r requirements.txt

4. Configure environment variables

Create a .env file in the project root (one is already included):

GROQ_API_KEY=your_groq_api_key_here

5. Run the application

Option A — MCP Server (exposes tools over the MCP protocol):

python server.py

Option B — CLI Client (interactive chat with keyword routing + Groq fallback):

python client.py

💬 Usage Examples

Ask : What is Rahul's attendance?
→ {'Name': 'Rahul', 'Days_Present': 42, 'Total_Days': 50, ...}

Ask : Show me Priya's average marks
→ Average = 82.4

Ask : What are the college rules?
→ (displays all rules from rules.txt)

Ask : Search notes for machine learning
Keyword : machine learning
→ (matching lines from notes.pdf)

Ask : Calculate 25+50*2
→ 125

Ask : What is the capital of France?
→ (answered by Groq Llama 3.3 70B)

Ask : exit
→ (exits the program)

🛠️ Tech Stack

MCP (Model Context Protocol) — tool registration & server
Groq — LLM inference (Llama 3.3 70B)
pandas — CSV data processing
pypdf — PDF text extraction
python-dotenv — environment variable management

📝 License

This project is for educational purposes.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Remote Desktop CommanderOAuth
app.desktopcommander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Shell Access OS Automation
237
Math MCP Learning A
io.github.clouatre-labs
Educational MCP server with 17 math/stats tools, visualizations, and persistent workspace
Education & Learning Tools Research & Data Developer Tools
1725
hjarni AOAuth
com.hjarni
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Note Taking Workplace & Productivity
383
mcp A
ai.llmse
Public MCP server for the LLM Search Engine
Search RAG Systems Developer Tools
102

Related MCP Servers

Modular MCP Server with Python
Shell Access Note Taking Weather Services
tunamsyar
F
license
Not graded
quality
D
maintenance
A demo MCP server that enables users to interact with various tools through natural language, including note management, weather queries, calculations, file operations, and shell commands. Uses Ollama for intent detection and structured command parsing from free text input.
Updated a year ago (2025-08-09 16:21 UTC)
-
Personal Toolkit MCP Server
Developer Tools App Automation
SANDEEP-KR-MAHTO
F
license
Not graded
quality
D
maintenance
A local MCP server providing text utilities, math functions, and a persistent todo list, enabling task automation via natural language in Claude Desktop.
Updated 3 months ago (2026-06-13 07:18 UTC)
-
ed-mcp
Education & Learning Tools Communication Search
januarharianto
A
license
A
quality
C
maintenance
An MCP server and CLI for Ed Discussion that gives LLMs access to threads, comments, attendance, moderation, file uploads, and instant local search through 43 tools.
Updated 5 months ago (2026-04-23 12:10 UTC)
43
2
MIT
MCPMathServer
Weather Services
vrxtxxx
F
license
Not graded
quality
C
maintenance
An MCP server that provides math tools (add, subtract, multiply) and a weather tool, with a LangChain agent client that uses Groq to answer natural language queries.
Updated 2 months ago (2026-07-26 08:59 UTC)
-