Skip to main content
Glama

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 build

Related MCP server: SG Gov MCP Server

连接它

Claude Code

claude mcp add purdue -- npx -y purdue-mcp

Claude Desktop / Cursor —— 添加到你的 MCP 配置中:

{
  "mcpServers": {
    "purdue": {
      "command": "npx",
      "args": ["-y", "purdue-mcp"]
    }
  }
}

工具

餐饮 —— Purdue HFS 餐饮 API

工具

它回答什么

dining_locations

每个餐饮广场 / Quick Bites / On-the-GO!,当前开放或下一餐时段开放情况

dining_menu

某个地点和日期的完整菜单,按餐次和摊位显示,支持纯素/素食/过敏原筛选

dining_find_item

“今天谁在供应鸡柳?” —— 同时搜索所有餐饮广场

dining_item_nutrition

任何菜单项目的完整营养信息

dining_line_length

众包实时排队长度报告(在用餐高峰时段前后由用户上报)

学术 —— Purdue.io 课程目录

工具

它回答什么

list_terms

学期代码和日期范围,最新的在前

list_subjects

所有学科代码(CS、MA、ENGR,…)

search_courses

按学科、编号或标题关键字搜索课程 —— 包含描述和学时

course_sections

某个学期的 CRN、课节类型、上课日期/时间、教室和教师

find_building

解析建筑代码,例如 LWSN → Lawson 计算机科学大楼

校园生活

工具

它回答什么

search_events

官方大学日历 —— 讲座、体育、招聘会、截止日期

search_student_orgs

BoilerLink 上约 1,200 个注册学生组织

search_club_events

即将到来的社团活动:招新、社交、会议

设施

工具

它回答什么

recwell_occupancy

所有 37 个被统计的 RecWell 场地的实时人数和容量百分比 —— “CoRec 现在有多忙”

library_hours

每个图书馆的今日开放时间和开放/关闭状态,或完整一周的开放时间

体育

工具

它回答什么

athletics_sports

每支校队及其当前赛季赛程

athletics_schedule

单支球队的完整赛季 —— 对手、排名、主/客场、场馆、成绩

athletics_upcoming

所有体育项目中接下来的 Boilermaker 比赛,按时间最近优先

出行

工具

它回答什么

bus_routes

服务校园及 Greater Lafayette 的每条 CityBus 路线

bus_stops

按名称查找站点,或查找最接近某个纬度和经度的站点

bus_next_departures

某个站点的下一班计划发车时间,以及预计等待分钟数

新闻和截止日期

工具

它回答什么

purdue_news

可搜索的官方新闻室文章

academic_calendar

开课第一天、假期、期末考试周、增/退课截止日期、考试安排

环境

工具

它回答什么

campus_weather

西拉法叶当前天气状况、预报和生效中的 NWS 警报

日期默认使用校园时区的今天(America/Indiana/Indianapolis),因此无论服务器在哪里运行,都能给出正确的答案。

数据源

来源

端点

备注

Purdue Dining (HFS)

api.hfs.purdue.edu/menus/v2

官方、公开、无需认证

Purdue.io

api.purdue.io/odata

社区运营的开源目录镜像(Purdue-io/PurdueApi)

Purdue Events

events.purdue.edu/api/2

Localist 公开 API

BoilerLink

purdue.campuslabs.com/engage/api/discovery

Anthology Engage 公开发现 API

Purdue RecWell

goboardapi.azurewebsites.net (Connect2)

实时占用计数器;账户密钥是 Purdue 官方公共组件所附带的那个

Purdue Libraries

calendar.lib.purdue.edu

Springshare LibCal 公开开放时间端点

Purdue Athletics

purduesports.com/website-api

官方体育网站公开 JSON API

Purdue Newsroom / Registrar

purdue.edu/{newsroom,registrar}/wp-json

WordPress REST API

CityBus

bus.gocitybus.com GTFS

静态时刻表源;没有公开的实时源

NOAA / NWS

api.weather.gov

公开的联邦 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 和缓存。

规则:

  1. 仅限公开数据。 任何需要 Purdue 登录的内容都不行,也不能涉及特定个人的信息。

  2. 在发布前验证端点是否可用 —— npm run smoke 会访问每一个真实上游,并且就是测试套件。

  3. 做一个礼貌的客户端。 合理的缓存 TTL,不要紧密轮询。

npm run build
npm run smoke   # live end-to-end check of all tools

许可证

MIT

Available Tools

29 tools
academic_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.

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.

dining_menuGet a dining court menuC

Full menu for one Purdue dining location on a date, by meal period and station, with dietary tags. Source: Purdue HFS dining API (live).

Inputs: location (required), date, meal, vegan_only, +2 more.

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

    A3.7/5.0

    Scored across 29 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that connects AI assistants to university D2L Brightspace and Piazza, enabling query of courses, grades, assignments, deadlines, files, and Piazza posts.
      7
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP 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
      -