AI导哈

食堂管理协议服务器

一个为IIIT食堂管理系统设计的模型上下文协议服务器，允许AI助手通过自然语言与食堂门户交互。

  • by NJP6969
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 NJP6969/IIITH-mess-MCP

使用说明

MCP服务器

用于IIIT信息管理系统的MCP（模型上下文协议）服务器。这使得像克劳德这样的人工智能助手能够通过自然语言与混乱门户进行交互。

特性

  • 🍽️ 查看菜单 -在所有餐厅获取任何日期的菜单
  • 📝 管理注册 -注册、取消或取消用餐
  • 💰 检查账单 -查看您的月度账单和预测
  • ⭐ 提交反馈 -评价和审查膳食
  • 🍕 额外项目 -查看并注册额外项目
  • 📅 月度计划 -管理每月的食堂登记
  • ⚙️ 偏好设置 -控制通知和用餐设置
  • 👤 个人资料 -查看您的用户信息

先决条件

安装

1.克隆和安装

git clone <your-repo-url>
cd mess-mcp
npm install

2.获取API密钥

  1. 登录到https://mess.iiit.ac.in
  2. 引导到 设置→ API密钥
  3. 点击 创建新密钥
  4. 为其命名（例如“MCP服务器”）并设置到期日期
  5. 立即复制密钥 （只显示一次！）

3.配置环境

复制示例环境文件并添加您的API密钥：

cp .env.example .env

编辑 .env 并替换 your-api-key-here 使用您的实际API密钥：

MESS_API_KEY=your-actual-api-key-here
MESS_API_URL=https://mess.iiit.ac.in/api

4.建设项目

npm run build

5.配置克劳德桌面

查找您的Claude Desktop配置文件：

  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

添加MCP服务器配置：

{
  "mcpServers": {
    "mess": {
      "command": "node",
      "args": ["/absolute/path/to/mess-mcp/dist/index.js"],
      "env": {
        "MESS_API_KEY": "your-actual-api-key-here",
        "MESS_API_URL": "https://mess.iiit.ac.in/api"
      }
    }
  }
}

重要：替换 /absolute/path/to/mess-mcp 了解项目的实际路径。

示例路径：

  • 窗户： "args": ["C:/Users/YourName/mess-mcp/dist/index.js"]
  • macOS/Linux： "args": ["/home/yourname/mess-mcp/dist/index.js"]

6.重新启动克劳德桌面

完全关闭Claude Desktop（检查系统托盘/菜单栏）并重新打开。MCP服务器将自动加载。

用法

设置后，您可以在Claude Desktop中使用自然语言与混乱系统进行交互：

对话示例

查看今天的菜单：

“今天午饭吃什么？” “给我看看Kadamba Veg今天的菜单”

用餐登记：

“明天在Yuktahar为我注册晚餐” “为我报名参加周五在Palash的早餐”

取消/管理注册：

“取消我明天的早餐” “显示我本周的注册信息” “取消12月5日的午餐”

检查账单：

“我这个月的账单是多少？” “到目前为止，我花了多少钱？”

查看容量：

“Kadamba今晚有空吃饭吗？” “给我看看明天午餐的空位”

提交反馈：

“给今天的午餐打4星级，并注明‘美食’”

管理首选项：

“关闭用餐提醒通知” “启用未注册的用餐权限”

可用工具

MCP服务器公开了30多种按类别组织的工具：

🏢 混乱信息

  • 获取混乱信息、菜单、价格、容量和时间

📝 注册

  • 查看、创建、取消和管理用餐登记

💰 账单和反馈

  • 检查账单、提交反馈、查看评分

🍕 额外项目

  • 浏览并注册额外的食品

📅 月度计划

  • 管理每月的食堂订阅

⚙️ 配置

  • 查看/更新首选项、检查窗口和限制

👤 用户档案

  • 查看个人资料，重置二维码令牌

发展

项目结构

mess-mcp/
├── src/
│   ├── index.ts           # Main MCP server entry point
│   ├── client.ts          # HTTP client for Mess API
│   ├── types.ts           # TypeScript type definitions
│   └── tools/
│       ├── auth.ts        # User authentication tools
│       ├── mess.ts        # Mess information tools
│       ├── registrations.ts # Registration management
│       ├── billing.ts     # Bills and feedback
│       ├── extras.ts      # Extra items
│       ├── monthly.ts     # Monthly registrations
│       └── config.ts      # Preferences and settings
├── dist/                  # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── .env                   # Your config (not in git)
├── .env.example           # Template for .env
└── README.md

脚本

  • npm run build -将TypeScript编译为JavaScript
  • npm run dev -构建并运行开发模式
  • npm start -运行已编译的服务器

故障排除

“未找到命令”或“未找到节点”

  • 确保Node.js已安装并位于系统PATH中
  • 尝试使用完整路径 node.exe 在Claude配置中

“未经授权”的错误

  • 在中验证您的API密钥是否正确 .env 和克劳德配置
  • 在混乱门户中检查您的API密钥是否已过期

MCP服务器未加载

  • 确保路径 claude_desktop_config.json 绝对正确
  • 检查Claude Desktop日志是否有错误
  • 配置更改后重新启动Claude Desktop

菜单不显示项目

  • 本周菜单可能不会更新
  • 尝试不同的日期或混乱

安全

  • 永不承诺 .env 文件 -它包含您的API密钥
  • 永远不要共享您的API密钥 -它提供了对您帐户的完全访问权限
  • 这 .gitignore 文件配置为排除敏感文件
  • 在混乱门户设置中定期旋转API键

贡献

欢迎投稿！拜托：

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

许可证

麻省理工学院

致谢

为海得拉巴IIIT的学生使用API会议管理系统建造。

支持

对于问题或疑问：

相关 MCP