Skip to content
Back to search

MCP-iiit-s

MCP-server for all IIIT SONEPAT related stuff

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shivanshumangal007-dev--mcp-iiit-s/badge.svg)](/listings/shivanshumangal007-dev--mcp-iiit-s)

HTML

<a href="/listings/shivanshumangal007-dev--mcp-iiit-s"><img src="/api/listings/shivanshumangal007-dev--mcp-iiit-s/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Local Development

# 1. Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate       # On Windows: .venv\Scripts\activate

# 2. Install dependencies
pip install -r requirements.txt

# 3. Start local server
uvicorn app:app --host 0.0.0.0 --port 8000 --reload

- **Documentation Website**: [http://localhost:8000](http://localhost:8000) - **MCP Endpoint**: [http://localhost:8000/mcp](http://localhost:8000/mcp) - **Health Check**: [http://localhost:8000/health](http://localhost:8000/health) - **Metadata API**: [http://localhost:8000/api/info](http://localhost:8000/api/info)

Testing with MCP Inspector

npx @modelcontextprotocol/inspector

Select **Streamable HTTP** and enter `http://localhost:8000/mcp`.

Running Unit Tests

python -m unittest discover -s tests

Runs the complete 20-test suite with zero external dependencies.

---

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 · 143 lines
  1. # IIIT Sonepat Model Context Protocol (MCP) Server
  2. [![FastMCP](https://img.shields.io/badge/MCP-FastMCP%20v1.x-orange.svg)](https://modelcontextprotocol.io/)
  3. [![Python](https://img.shields.io/badge/Python-3.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://python.org)
  4. [![Vercel Serverless](https://img.shields.io/badge/Vercel-Serverless%20Ready-black.svg)](https://vercel.com)
  5. [![Render](https://img.shields.io/badge/Render-Deploy%20Ready-46E3B7.svg)](https://render.com)
  6. [![Tests](https://img.shields.io/badge/Tests-20%20Passed-brightgreen.svg)]()
  7. A production-grade, stateless [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server providing structured intelligence and analytics for the **Indian Institute of Information Technology (IIIT), Sonepat** (An Institute of National Importance under an Act of Parliament, MoE, GoI).
  8. Every tool returns structured data, direct download links for files, a deep-link anchor to the local documentation site (`source`), and authoritative institute URLs (`official_source`).
  9. ---
  10. ## Architecture
  11. The codebase is built on a clean, decoupled, modular architecture with zero circular dependencies:
  12. ```
  13. MCP-iiit-s/
  14. ├── app.py # Server assembly, FastMCP instance, tool registrations & web routes
  15. ├── common.py # Shared configuration, base URL resolution, reply formatters, safe loaders
  16. ├── about_us.py # About Us: Governance, vision, mission, programs, MoUs, RTI, policies
  17. ├── faculty.py # Faculty: 17 profiles, departmental filters, research expertise search
  18. ├── api/
  19. │ └── mcp.py # Serverless entrypoint wrapping ASGI with Mangum and CORS
  20. ├── data/
  21. │ ├── college.json # Core institute metadata, contacts, social handles, file manifests
  22. │ ├── aboutus.json # Comprehensive institute governance, MoUs, and academic data
  23. │ └── faculty.json # 17 faculty profiles across 4 academic departments
  24. ├── files/ # Downloadable assets (logo.png, logo.svg, brochure.pdf)
  25. ├── site/
  26. │ └── index.html # Clean, responsive web documentation & client configuration UI
  27. ├── tests/ # Complete unit test suite (20 tests)
  28. │ ├── test_common.py
  29. │ ├── test_about_us.py
  30. │ └── test_faculty.py
  31. ├── vercel.json # Vercel serverless routing & asset bundle configuration
  32. └── requirements.txt # Production dependencies
  33. ```
  34. ---
  35. ## MCP Tools Reference
  36. ### 1. General & Core Tools
  37. - `get_college_info()`: Overview of IIIT Sonepat (established 2014, PPP model, mentored by NIT Kurukshetra, MoE, GoI).
  38. - `get_director()`: Name, designation, Ph.D. qualification, email, profile, and vision message of Director Prof. (Dr.) Manisha Sharma.
  39. - `get_contact()`: Address at IIT Delhi Techno Park (Rajiv Gandhi Education City, Rai, Sonepat), phone numbers, email, and social media handles.
  40. - `list_files(category=None)`: Downloadable documents and logos with availability and direct URLs.
  41. - `get_logo()`: Direct links to official PNG and SVG emblems.
  42. - `search_info(query)`: Fast keyword search indexed over **140+ structured snippets** spanning academics, faculty, governance, MoUs, and committees.
  43. ### 2. Academic & Governance Tools (`about_us.py`)
  44. - `get_vision_and_mission()`: Guiding institutional principles: 2 vision statements & 4 mission statements.
  45. - `get_courses()`: Undergraduate degree programs: B.Tech in CSE, IT, Data Science & Analytics, and Artificial Intelligence.
  46. - `get_visitor()`: Details of the Visitor (Her Excellency Honorable Smt. Droupadi Murmu, The President of India).
  47. - `get_governance(body=None)`: Statutory governing bodies (filter by `'bog'`, `'senate'`, `'finance'`, `'building'`, or view all):
  48. - **Board of Governors**: 13 members chaired by Mrs. Kavita Khanna
  49. - **Senate**: 7 members chaired by Director Prof. Manisha Sharma
  50. - **Finance Committee**: 5 members chaired by Smt. Kavita Khanna
  51. - **Building & Works Committee**: 5 members chaired by Dr. Manisha Sharma
  52. - `get_administration_committees(role=None)`: 14 institute committees for AY 2025-26 with faculty-in-charge (Admissions, Placement / Alumni, R&D, Academics, Exam cell, Digital Outreach, etc.).
  53. - `get_mous(partner=None)`: 7 strategic academic/research MoUs (SVNIT Surat, IIT Bhilai, MNIT Jaipur, IIT Hyderabad, NIT Delhi, NYUST Taiwan, DTU).
  54. - `get_rti_info()`: Right to Information officials (Appellate Authority Dr. Diddi Kumara Swamy, PIO Dr. Mohan Bansal), emails, and disclosure audit documents.
  55. - `get_policies_and_acts()`: Reservation policy compliance (SC/ST/OBC-NCL/EWS/PwBD) and statutory Acts (IIIT PPP Act 2017, POSH 2013, RPN 2016, 4-tier faculty structure).
  56. - `get_annual_reports()`: Annual progress reports (2021-22 through 2025-26) with release dates.
  57. ### 3. Faculty & Research Directory Tools (`faculty.py`)
  58. - `get_faculty(department=None, name=None)`: 17 faculty profiles filtered by department (`'CSE'`, `'ECE'`, `'Mathematics'`, `'Humanities'`) or name.
  59. - `search_faculty(query)`: Relevancy-ranked search matching faculty expertise (e.g. "Artificial Intelligence", "IoT", "Quantum Computing", "Transportation Systems").
  60. ---
  61. ## Getting Started
  62. ### Local Development
  63. ```bash
  64. # 1. Create and activate virtual environment
  65. python -m venv .venv
  66. source .venv/bin/activate # On Windows: .venv\Scripts\activate
  67. # 2. Install dependencies
  68. pip install -r requirements.txt
  69. # 3. Start local server
  70. uvicorn app:app --host 0.0.0.0 --port 8000 --reload
  71. ```
  72. - **Documentation Website**: [http://localhost:8000](http://localhost:8000)
  73. - **MCP Endpoint**: [http://localhost:8000/mcp](http://localhost:8000/mcp)
  74. - **Health Check**: [http://localhost:8000/health](http://localhost:8000/health)
  75. - **Metadata API**: [http://localhost:8000/api/info](http://localhost:8000/api/info)
  76. ### Testing with MCP Inspector
  77. ```bash
  78. npx @modelcontextprotocol/inspector
  79. ```
  80. Select **Streamable HTTP** and enter `http://localhost:8000/mcp`.
  81. ### Running Unit Tests
  82. ```bash
  83. python -m unittest discover -s tests
  84. ```
  85. Runs the complete 20-test suite with zero external dependencies.
  86. ---
  87. ## Deployment
  88. ### Deploying to Vercel (Serverless)
  89. This repository is configured for zero-config Vercel Serverless deployment using the Mangum ASGI adapter:
  90. 1. Push this repository to GitHub.
  91. 2. In the [Vercel Dashboard](https://vercel.com/new), import the repository.
  92. 3. Vercel automatically detects the configuration from `vercel.json` and `api/mcp.py`.
  93. 4. Your MCP server will be live at `https://<your-project>.vercel.app/mcp`.
  94. 5. *(Optional)* Set `BASE_URL` in your Vercel Project Environment Variables if using a custom domain.
  95. ### Deploying to Render
  96. 1. In the Render Dashboard, create a **New > Blueprint** and link your repo (it reads `render.yaml`).
  97. 2. Your MCP server will be live at `https://<your-service>.onrender.com/mcp`.
  98. ---
  99. ## Connecting to MCP Clients
  100. ### Claude Desktop / Claude Code
  101. In Claude's settings or connector configuration:
  102. ```json
  103. {
  104. "mcpServers": {
  105. "iiit-sonepat": {
  106. "url": "https://<your-deployment-url>/mcp"
  107. }
  108. }
  109. }
  110. ```
  111. ### Cursor
  112. In Cursor Settings > Features > MCP > Add New MCP Server:
  113. - **Name**: `iiit-sonepat`
  114. - **Type**: `Streamable HTTP`
  115. - **URL**: `https://<your-deployment-url>/mcp`

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.