cgpa_mcp_server
PUCIT GPA Assistant - Assignment 3
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 21 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ridaamir85/cgpa_mcp_server with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ridaamir85/cgpa_mcp_server'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/ridaamir85--cgpa-mcp-server)HTML
<a href="/listings/ridaamir85--cgpa-mcp-server"><img src="/api/listings/ridaamir85--cgpa-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 100 lines
- # PUCIT GPA Assistant - Assignment 3
- The GPA/CGPA assistant uses MCP tools, persistent SQLite memory, asynchronous execution, streaming, and interrupted-tool-call recovery. This GitHub repository contains the server files at its root; the full local assignment has separate `agent/` and `server/` folders.
- ## Deployment details
- - Hosted MCP server: https://cgpa-mcp-server.onrender.com/mcp
- - MCP authentication: Not required; the current endpoint is public and does not check an API key.
- - Server GitHub repository: https://github.com/ridaamir85/cgpa_mcp_server
- The Groq API key belongs to the separate agent application. This tool server does not require it.
- ## Available tools
- - `marks_to_grade_points`
- - `calculate_semester_gpa`
- - `calculate_new_cgpa`
- - `required_gpa_for_target`
- - `get_semester_courses`
- - `get_remaining_credit_hours`
- - `save_report`
- ## Test the hosted server
- ```powershell
- fastmcp list https://cgpa-mcp-server.onrender.com/mcp
- fastmcp call https://cgpa-mcp-server.onrender.com/mcp get_semester_courses semester=6
- ```
- Render's free instance may take time to wake after inactivity. The `/mcp` endpoint is intended for MCP clients; opening it directly in a browser may return a missing-session error.
- ## Connect the agent
- Set these values in the separate agent's `.env` file:
- ```text
- MCP_URL=https://cgpa-mcp-server.onrender.com/mcp
- FASTMCP_KEY=
- ```
- Keep the agent's existing `GROQ_API_KEY` configured locally. Never commit its `.env` file.
- ## Run locally
- The commands below run the server from this GitHub repository. In the full assignment folder, enter `server/` first.
- ```powershell
- python -m pip install -r requirements.txt
- python server.py
- ```
- Local MCP URL: `http://127.0.0.1:8000/mcp`. The server reads `PORT` when supplied by the hosting platform and otherwise uses port 8000.
- ## Run the full assignment agent
- From the full assignment folder, install its dependencies with `py -m pip install -r requirements.txt`. Copy `agent/.env.example` to `agent/.env` only if `.env` does not already exist. Add your Groq key and the hosted MCP settings shown above.
- ```powershell
- cd agent
- py agent.py
- ```
- Enter a name to select a `thread_id`. Commands are `/switch`, `/history`, `/forget`, and `exit`. The SQLite checkpointer preserves messages in `chats.db` in the working directory, so consistently run the client from `agent/`. SQLite may automatically create `chats.db-wal` and `chats.db-shm`.
- Streaming displays model text through `messages` and model/tool progress through `updates`. Recovery adds matching error ToolMessages for the supported case of an interrupted run ending with unanswered model tool calls.
- No local MCP server is needed when using Render. To test locally, run `server.py` in another terminal, change `MCP_URL` to the local endpoint, and restart the agent.
- ## Optional GUI from the earlier assignment
- The full local assignment also includes `agent/app.py`, the optional Streamlit interface carried over from the earlier GPA assignment. Keep the Streamlit dependency when including this file. The server-only GitHub repository does not contain the GUI or agent files.
- The main Assignment 3 interface is the `agent.py` terminal client. Demonstrate streaming and the `/switch`, `/history`, and `/forget` commands through that terminal client. The optional GUI does not provide the same terminal commands or live streaming display.
- To launch the GUI from the full assignment folder:
- ```powershell
- cd agent
- py -m streamlit run app.py
- ```
- Open the local URL printed by Streamlit, usually `http://localhost:8501`. It uses the MCP URL configured in `agent/.env`; when that URL points to Render, no local MCP server is needed. The GUI should be tested separately before submission.
- ## Render configuration
- - Runtime: Python
- - Build command: `pip install -r requirements.txt`
- - Start command: `python server.py`
- - Root directory: blank for this GitHub repository
- - Compute: Free
- ## Report storage
- `save_report` writes `.txt` reports into the server's `reports` directory and refuses to overwrite an existing filename. Reports are stored on the server, not downloaded to the client computer. Render's free filesystem is temporary, so reports may be lost after restarts or redeployments.
- ## Submission
- Submit `BCSF24M052_Assignment3.zip` containing the assignment's `agent/`, `server/`, dependency file, and README. Include `agent/.env.example`.
- Exclude real `.env` files, chat databases and their companion files, `__pycache__/`, virtual environments, and generated reports. The Streamlit interface and development test are optional; the terminal agent does not require them.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.