Mess MCP Server
A Model Context Protocol (MCP) server for the IIIT-H Mess portal. This server provides robust, real-time integration enabling AI assistants to securely interact with the institution's mess dining and marketplace systems over standard STDIO transports.
Architecture & Features
The server interfaces via the official Anthropic mcp SDK, abstracting the mess.iiit.ac.in/api into easily digestible Resources, Tools, and Prompts.
- Resources: Exposes static read-only constraints such as system capacities, current multi-week menus, available extras, operating hours, and standard meal rates.
- Tools: Authorizes state mutations including modifying registrations (cancel, skip, un-cancel, register), applying for extras, and seamlessly filing formal qualitative feedback.
- Prompts: Provides pre-programmed reasoning flows, assisting agents with weekly meal planning and historic billing analysis, mitigating overspending on non-essential items.
Prerequisites
- Python 3.10+
- uv (recommended for seamless environments) or pip
Installation
- Clone the repository to your local environment:
git clone https://github.com/shrey715/mess-mcp.git
cd mess-mcp- Sync the dependencies and build the virtual environment:
uv sync
# Or using standard pip
pip install .Configuration
The server operations are authenticated. You must set the correct environment variables before launch, preventing API tokens from passing unnecessarily through the language model context window.
export MESS_API_KEY="your-api-token"Usage Integration
The server operates exclusively via standard stdio, assuring strong compatibility with high-performance desktop clients.
Claude Desktop Integration
Locate your Claude Desktop JSON configuration and append the following:
{
"mcpServers": {
"mess-mcp": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mess-mcp", "mess-mcp"],
"env": {
"MESS_API_KEY": "your-api-key"
}
}
}
}Cursor or VS Code Integration
Use standard integration settings inside Cursor or VS Code Copilot to register local MCPs. Provide the exact executable invocation:
Command Path: uv run --directory /path/to/mess-mcp mess-mcp
Documentation
Full architectural insights are encoded directly into the MCP introspection system (mcp list). Endpoints trace the official OpenAPI 3.0 specification available from the institution portal.
License
This software is released under the GNU General Public License v3.0 (GPLv3). Review the LICENSE file for strict distribution and modification stipulations.
