purdue-mcp
purdue-mcp
一个 MCP 服务器,用于所有公开、实时的 Purdue University 数据 —— 餐饮菜单、健身房实时人数、课程目录、公交时间、校园活动、学生组织、图书馆开放时间、体育、新闻和天气。将任何 MCP 客户端(Claude Code、Claude Desktop、Cursor,…)指向它,然后问 “Wiley 晚餐吃什么”、“CoRec 现在有多拥挤” 或 “下一班从 PMU 出发的公交车什么时候到”。
非官方且由社区维护。与 Purdue University 无关联、未获其认可,也非由其运营。
安装
npm install -g purdue-mcp或者直接从仓库运行:
git clone https://github.com/sharziki/purdue-mcp && cd purdue-mcp
npm install && npm run buildRelated MCP server: SG Gov MCP Server
连接它
Claude Code
claude mcp add purdue -- npx -y purdue-mcpClaude Desktop / Cursor —— 添加到你的 MCP 配置中:
{
"mcpServers": {
"purdue": {
"command": "npx",
"args": ["-y", "purdue-mcp"]
}
}
}工具
餐饮 —— Purdue HFS 餐饮 API
工具 | 它回答什么 |
| 每个餐饮广场 / Quick Bites / On-the-GO!,当前开放或下一餐时段开放情况 |
| 某个地点和日期的完整菜单,按餐次和摊位显示,支持纯素/素食/过敏原筛选 |
| “今天谁在供应鸡柳?” —— 同时搜索所有餐饮广场 |
| 任何菜单项目的完整营养信息 |
| 众包实时排队长度报告(在用餐高峰时段前后由用户上报) |
学术 —— Purdue.io 课程目录
工具 | 它回答什么 |
| 学期代码和日期范围,最新的在前 |
| 所有学科代码(CS、MA、ENGR,…) |
| 按学科、编号或标题关键字搜索课程 —— 包含描述和学时 |
| 某个学期的 CRN、课节类型、上课日期/时间、教室和教师 |
| 解析建筑代码,例如 |
校园生活
工具 | 它回答什么 |
| 官方大学日历 —— 讲座、体育、招聘会、截止日期 |
| BoilerLink 上约 1,200 个注册学生组织 |
| 即将到来的社团活动:招新、社交、会议 |
设施
工具 | 它回答什么 |
| 所有 37 个被统计的 RecWell 场地的实时人数和容量百分比 —— “CoRec 现在有多忙” |
| 每个图书馆的今日开放时间和开放/关闭状态,或完整一周的开放时间 |
体育
工具 | 它回答什么 |
| 每支校队及其当前赛季赛程 |
| 单支球队的完整赛季 —— 对手、排名、主/客场、场馆、成绩 |
| 所有体育项目中接下来的 Boilermaker 比赛,按时间最近优先 |
出行
工具 | 它回答什么 |
| 服务校园及 Greater Lafayette 的每条 CityBus 路线 |
| 按名称查找站点,或查找最接近某个纬度和经度的站点 |
| 某个站点的下一班计划发车时间,以及预计等待分钟数 |
新闻和截止日期
工具 | 它回答什么 |
| 可搜索的官方新闻室文章 |
| 开课第一天、假期、期末考试周、增/退课截止日期、考试安排 |
环境
工具 | 它回答什么 |
| 西拉法叶当前天气状况、预报和生效中的 NWS 警报 |
日期默认使用校园时区的今天(America/Indiana/Indianapolis),因此无论服务器在哪里运行,都能给出正确的答案。
数据源
来源 | 端点 | 备注 |
Purdue Dining (HFS) |
| 官方、公开、无需认证 |
Purdue.io |
| 社区运营的开源目录镜像(Purdue-io/PurdueApi) |
Purdue Events |
| Localist 公开 API |
BoilerLink |
| Anthology Engage 公开发现 API |
Purdue RecWell |
| 实时占用计数器;账户密钥是 Purdue 官方公共组件所附带的那个 |
Purdue Libraries |
| Springshare LibCal 公开开放时间端点 |
Purdue Athletics |
| 官方体育网站公开 JSON API |
Purdue Newsroom / Registrar |
| WordPress REST API |
CityBus |
| 静态时刻表源;没有公开的实时源 |
NOAA / NWS |
| 公开的联邦 API |
响应在进程内以短 TTL 缓存(30s–24h,具体取决于数据变化速度),以保持一个礼貌的客户端。不会将任何内容持久化到磁盘。
已排除(经调查,无公开来源)
洗衣机可用性 —— Purdue 已将宿舍洗衣服务迁移到 CSCPay Mobile,该服务没有公开的网页状态页。社区应用之前抓取的旧
washalertweb主机已不再解析。实时公交位置 —— CityBus 仅发布 GTFS 静态数据。Transitland 或 Mobility Database 上未列出 GTFS-Realtime 源,MyRide 的后端也不公开。
bus_next_departures返回的是时刻表时间。停车库可用性 —— Purdue Parking 不发布实时空位数量。
座位可用性 / 等待列表 —— 需要 myPurdue 登录才能访问。按设计不在范围内。
添加数据源
每个数据源是 src/sources/ 中的一个文件,导出一个 registerX(server),该函数调用 server.registerTool(...)。在 src/index.ts 中注册它。使用来自 src/lib/http.ts 的 getJSON(),这样你会继承超时、User-Agent 和缓存。
规则:
仅限公开数据。 任何需要 Purdue 登录的内容都不行,也不能涉及特定个人的信息。
在发布前验证端点是否可用 ——
npm run smoke会访问每一个真实上游,并且就是测试套件。做一个礼貌的客户端。 合理的缓存 TTL,不要紧密轮询。
npm run build
npm run smoke # live end-to-end check of all tools许可证
MIT
Available Tools
29 toolsacademic_calendarPurdue academic calendar and registrar infoA
The official academic calendar — first day of classes, breaks, finals week, commencement — plus any registrar page (add/drop deadlines, exam scheduling, grade policies) by keyword. Source: purdue.edu/registrar (WordPress REST API, live).
Inputs: limit, query.
athletics_schedulePurdue team scheduleA
Full season schedule for one Purdue team — dates, opponents, home/away, venue, and final scores where played. Source: purduesports.com (official athletics site API).
Inputs: sport (required), upcoming_only.
athletics_sportsList Purdue varsity sportsB
Every Purdue varsity sport and its current schedule id. Source: purduesports.com (official athletics site API).
Inputs: no named parameters.
athletics_upcomingNext Purdue games across all sportsA
The next Boilermaker games across every varsity sport, soonest first — what to go watch this week. Source: purduesports.com (official athletics site API).
Inputs: days, limit, home_only.
banner_termsList Banner registration termsA
Terms available in Purdue's live registration system, newest first. Terms marked 'View only' are closed to registration. Source: Purdue Banner self-service.
Inputs: no named parameters.
bus_next_departuresNext scheduled buses from a stopA
Next scheduled CityBus departures from a stop today, by route and headsign. These are timetable times — CityBus publishes no public real-time feed, so buses may run early or late. Source: CityBus GTFS feed.
Inputs: stop (required), date, limit.
bus_routesList CityBus routesA
Every CityBus route serving Purdue and Greater Lafayette. Source: CityBus GTFS feed (scheduled service; CityBus publishes no public real-time feed).
Inputs: query.
bus_stopsFind CityBus stopsA
Search CityBus stops by name, or find the stops nearest a latitude/longitude on campus. Source: CityBus GTFS feed.
Inputs: lat, lon, limit, query.
campus_weatherPurdue campus weatherA
Current conditions and forecast for the Purdue West Lafayette campus, plus any active severe-weather alerts. Source: NOAA/NWS api.weather.gov (live).
Inputs: hourly, periods.
course_availabilityLive seat and waitlist counts for a courseA
How many seats are actually open in each section of a course right now, with waitlist counts, CRNs, meeting times, and instructors. This is the authoritative registration data — use it over search_courses/course_sections when the question is 'can I get in'. Source: Purdue Banner self-service (public, live).
Inputs: number (required), subject (required), term, limit, +1 more.
course_sectionsGet sections and meeting times for a courseB
CRNs, section types, meeting days/times, rooms, and instructors for a course in a given term. Source: Purdue.io.
Inputs: number (required), subject (required), term.
dining_find_itemFind a food item across dining courtsA
Search every Purdue dining court's menu for a dish on a given date — answers 'who is serving chicken tenders today'. Source: Purdue HFS dining API (live).
Inputs: query (required), date, meal, include_retail.
dining_item_nutritionNutrition facts for a dining itemA
Full nutrition panel for one menu item, by the item id returned from dining_menu or dining_find_item. Source: Purdue HFS dining API (live).
Inputs: item_id (required).
dining_line_lengthLive dining court line lengthsA
Crowdsourced real-time line-length reports for Purdue dining courts. Often empty outside peak hours. Source: Purdue HFS dining API (live).
Inputs: no named parameters.
dining_locationsList Purdue dining locationsA
List every Purdue dining location (dining courts, quick bites, On-the-GO!) with whether it is open right now and the next meal period. Source: Purdue HFS dining API (live).
Inputs: type, open_now.
find_buildingLook up a campus buildingA
Resolve a Purdue building short code or name (e.g. 'LWSN' -> Lawson Computer Science Building). Source: Purdue.io.
Inputs: query.
library_hoursPurdue library hoursA
Today's hours and open/closed status for every Purdue library and study space (WALC, Hicks, HSSE, Parrish, Archives, …), or a full week's grid. Source: Purdue Libraries LibCal (live).
Inputs: week, query, open_now.
list_subjectsList course subjectsA
All course subject codes at Purdue (CS, MA, ENGR, …), optionally filtered by name. Source: Purdue.io.
Inputs: query.
list_termsList Purdue academic termsA
Every term in the Purdue course catalog, newest first, with codes and date ranges. Use the code with the other course tools. Source: Purdue.io (community catalog mirror).
Inputs: limit.
purdue_exponentPurdue Exponent student newspaperB
Articles from the Purdue Exponent, the independent student newspaper — campus reporting, student government, local news, sports coverage. Editorially independent of the university. Source: purdueexponent.org public feed.
Inputs: limit, section.
purdue_newsPurdue University newsA
Official Purdue newsroom articles — research announcements, university decisions, campus news — searchable by keyword. Source: purdue.edu/newsroom (WordPress REST API, live).
Inputs: limit, query, full_text.
recwell_occupancyLive gym / CoRec occupancyA
Real-time headcount and percent-of-capacity for every counted Purdue RecWell space — CoRec fitness floors, tracks, courts, climbing walls, pools. Answers 'how busy is the gym right now'. Source: Purdue RecWell live facility counts (updates ~every 30s).
Inputs: sort, query, open_only.
reddit_purdueWhat Purdue students are talking aboutA
Current posts from r/Purdue — the unofficial student pulse: housing and sublease chatter, campus gripes, events, advice threads, what is actually happening this week. Unofficial and unmoderated by the university; treat as opinion, not fact. Source: reddit.com/r/Purdue public feed.
Inputs: sort, limit.
search_club_eventsSearch student-org events on BoilerLinkA
Upcoming student organization events (club meetings, socials, callouts) with time, room, and host org. Distinct from the official university calendar. Source: BoilerLink / Anthology Engage (live).
Inputs: limit, query.
search_coursesSearch the Purdue course catalogB
Find courses by subject code, course number, and/or title keyword — returns titles, credit hours, and descriptions. Source: Purdue.io.
Inputs: limit, number, subject, title_contains.
search_eventsSearch official Purdue campus eventsB
Official university event calendar (lectures, athletics, concerts, deadlines, career fairs) with times, locations, and links. Source: events.purdue.edu (Localist, live).
Inputs: days, limit, query, start.
search_student_orgsSearch Purdue student organizationsB
Search BoilerLink's directory of ~1,200 registered student organizations by name or keyword. Source: BoilerLink / Anthology Engage (live).
Inputs: limit, query.
section_detailsFull registration detail for one CRNA
Everything Banner knows about one section: seats, waitlist, prerequisites, and major/level restrictions. Answers 'why can't I register for this'. Meeting times come from course_availability or course_sections. Source: Purdue Banner self-service (public, live).
Inputs: crn (required), term.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Each tool targets a distinct resource and action, such as bus stops versus departures, dining locations versus menus, and course search versus availability. The descriptions clearly differentiate overlapping domains like official events and club events.
All 29 tools follow a consistent snake_case pattern with a domain-specific prefix (bus_, dining_, list_, search_, etc.) and a descriptive verb or noun. The naming is predictable and easy to interpret.
With 29 tools, the set is on the high side, exceeding the typical 3-15 range for a well-scoped server. However, the server covers a broad range of university functions (dining, transportation, courses, events, athletics, etc.), and each tool serves a specific purpose, making the count borderline reasonable.
The server covers most common Purdue queries: dining, bus, courses, registration, events, athletics, news, calendar, library, weather, recwell, and student organizations. Minor gaps like parking or a campus map exist, but the surface is extensive and cohesive.
Maintenance
Related MCP Connectors
This MCP server provides seamless access to Malaysia's government open data, including datasets, w…
Public MCP server for discovering open jobs. Search, filter, and get application links.
One MCP server for 180+ live web-data APIs returning clean JSON from sites that block scrapers.
The official Planning Center MCP server for interacting with your ministry's data.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceAn MCP server that connects AI assistants to university D2L Brightspace and Piazza, enabling query of courses, grades, assignments, deadlines, files, and Piazza posts.7MIT
- AlicenseAqualityDmaintenanceUnified MCP server offering 30 tools for Singapore government and public data including weather, transport, education, and property, with many tools working immediately without API keys.34MIT
- FlicenseNot gradedqualityCmaintenanceMCP server that aggregates department notices and provides structured answers to queries about courses, schedules, and academic dates via tool calling.-
- FlicenseAqualityDmaintenanceMCP server for St. Louis transit developer tooling, providing 45 tools for GTFS and GTFS-Realtime inspection, feed surveillance, schedule and arrival queries, assertions, drift detection, and golden-fixture generation for the Light Phone 3 Kotlin transit app, all backed by public unauthenticated sources.45-