USC WebReg/Course Catalog MCP
USC WebReg/Course Catalog MCP
MCP 服务器,为 AI 代理提供南加州大学(USC)公开课程目录 API(classes.usc.edu)的访问。允许你提出诸如"周二/周四中午之后开始的 GE B 选项有哪些?"之类的问题。
设置
构建一次:
npm install
npm run buildopencode
添加到 ~/.config/opencode/opencode.jsonc:
{
"mcp": {
"usc-courses": {
"type": "local",
"command": ["node", "/absolute/path/to/usc-webreg-mcp/dist/index.js"],
"enabled": true
}
}
}Claude Code
在项目根目录添加 .mcp.json(或运行 claude mcp add):
{
"mcpServers": {
"usc-courses": {
"command": "node",
"args": ["/absolute/path/to/usc-webreg-mcp/dist/index.js"]
}
}
}Related MCP server: Brown Courses MCP Server
工具
工具 | 描述 |
| 所有学期,含季节/年份/状态 |
| 按 termCode 获取单个学期详情(例如 |
| 某学期的学院/学校及其专业 |
| 某学期的专业(系)及其所属学院 |
| 专业详情/备注(D-clearance 信息) |
| 目录中的所有学科前缀 |
| 注册时段和退课日期 |
| 课程代码是否存在于目录中 |
| 某学期的 SimpleSyllabus 索引 URL |
| 按 |
| 目录关键词搜索(代码/标题/描述) |
| 完整课程记录,包括所有课程段、先修要求和限制 |
| 某学院+专业的所有课程 |
| GE 结构(要求 + 类别前缀) |
| 满足某 GE 类别的课程 |
| 某 GE 类别的名称/详情 |
时间表筛选
search_courses、list_courses_by_program 和 list_courses_by_ge 接受可选的课程段筛选条件:days(["Mon","Wed"])、startAfter/startBefore("12:00")和 openOnly。
示例:周一+周三中午及之后上课的 GE B 课程:
list_courses_by_ge(termCode=20263, geRequirementPrefix=ACORELIT,
geCategoryPrefix=HINQ, days=["Mon","Wed"], startAfter="12:00")Available Tools
16 toolscheck_course_existsARead-onlyIdempotent
Check whether a course code exists anywhere in the USC catalog (not limited to a single term). Accepts codes like 'CSCI-103'. Returns true/false.
Inputs: course (required).
get_courseARead-onlyIdempotent
Get the full record for a single USC course in a term by its course code (e.g. 'CSCI-103'). Includes description, units, GE code, prerequisites, corequisites, restrictions, and all sections with schedule, instructor, seats, fees, and syllabus URL. Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.
Inputs: termCode (required), courseCode (required), days, openOnly, +2 more.
get_ge_category_detailsARead-onlyIdempotent
Get the name and details of a single General Education (GE) category within a requirement for a term. Useful to confirm what a GE category prefix means (e.g. what 'HINQ' covers).
Inputs: termCode (required), geCategoryPrefix (required), geRequirementPrefix (required).
get_programARead-onlyIdempotent
Get details for a single USC program in a term, including program-specific notes (e.g. enrollment or D-clearance instructions). Requires the program's school prefix (find via list_programs) and the program prefix.
Inputs: school (required), program (required), termCode (required).
get_section_feesARead-onlyIdempotent
Get the fees for a single course section by its SIS section id (the 'sisSectionId' field on a section, e.g. '29934'). Returns any tuition/fee items attached to the section.
Inputs: sectionId (required).
get_syllabus_indexARead-onlyIdempotent
Get the SimpleSyllabus index URL for a term, which can be used to look up published syllabi for that term's sections. Individual sections also carry a 'syllabus' URL directly.
Inputs: termCode (required).
get_termARead-onlyIdempotent
Get details for a single academic term by its numeric termCode (e.g. 20263 = Fall 2026). Returns season, year, status, and activation date.
Inputs: termCode (required).
list_course_prefixesARead-onlyIdempotent
List every USC subject prefix in the catalog (e.g. CSCI, MATH, AHIS) across all terms, with its name. Useful for discovering what subjects exist.
Inputs: no named parameters.
list_courses_by_geARead-onlyIdempotent
List all courses in a term that satisfy a General Education (GE) category, with their sections. Requires the GE requirement prefix and category prefix, which can be discovered via list_ge_requirements (e.g. GE B 'Humanistic Inquiry' = geRequirementPrefix 'ACORELIT', geCategoryPrefix 'HINQ'). Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.
Inputs: termCode (required), geCategoryPrefix (required), geRequirementPrefix (required), days, +3 more.
list_courses_by_programARead-onlyIdempotent
List all courses offered by a USC program (department) in a term. Requires the school prefix and program prefix, which can be discovered via list_programs. For example, Computer Science is school 'ENGV' and program 'CSCI'. Returns courses with their sections. Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.
Inputs: school (required), program (required), termCode (required), days, +3 more.
list_ge_requirementsARead-onlyIdempotent
List USC General Education (GE) requirements for a term. Returns the GE structure grouped by requirement era ('Fall2015OrLater' for current students, 'BeforeFall2015' for older catalogs). Each requirement has a prefix and categories with prefixes (e.g. GE B 'Humanistic Inquiry' is category prefix 'HINQ' under requirement 'ACORELIT'). Use the prefixes with list_courses_by_ge.
Inputs: termCode (required).
list_programsARead-onlyIdempotent
List all USC programs (departments/majors) in a term, each with its prefix, name, and the school prefix(es) it belongs to. Use this to find the school+program pair needed for list_courses_by_program (e.g. Computer Science is program 'CSCI' under school 'ENGV').
Inputs: termCode (required).
list_schoolsARead-onlyIdempotent
List all USC schools/colleges offering classes in a term, each with its prefix (e.g. 'ENGV' = Viterbi, 'DRNS' = Dornsife) and the programs (departments) it contains. Useful for navigating the catalog structure.
Inputs: termCode (required).
list_sessionsARead-onlyIdempotent
List USC enrollment sessions (e.g. regular session '001', summer sessions) with their term, session code, description, last drop date, and RNR session id. Useful for understanding session codes shown on sections.
Inputs: no named parameters.
list_termsARead-onlyIdempotent
List all USC academic terms available in the course catalog, each with season, year, term code, and status. Use this to find the termCode for a given semester (e.g. 20263 = Fall 2026).
Inputs: no named parameters.
search_coursesARead-onlyIdempotent
Search the USC course catalog for a term by keyword. Matches course codes, titles, and descriptions (e.g. 'machine learning', 'CSCI', 'art history'). Returns matching courses with their sections, including schedule, instructor, and seat availability. Supports optional section filters (days, startAfter, startBefore, openOnly) applied client-side.
Inputs: termCode (required), searchTerm (required), days, openOnly, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools cleanly separate listing, detail lookup, and course discovery, but a few overlaps exist: check_course_exists is similar to get_course/search_courses, and the multiple list_courses_* variants all return courses with sections. Descriptions are specific enough that an agent can usually pick correctly, though some boundary cases require close reading.
Tool names follow a consistent verb_noun pattern: list_* for collections, get_* for single records, and search_courses/check_course_exists as clear special cases. All names are snake_case, and related tools are predictably grouped.
16 tools is slightly above the ideal range but justifiable given the domain's breadth: terms, schools, programs, course prefixes, sessions, GE requirements, fees, and syllabi all need coverage. A couple of tools like check_course_exists or get_syllabus_index feel auxiliary, but they do not make the set bloated.
The catalog surface is well covered: term navigation, program/school structure, course search and detail, GE lookup, sections, fees, sessions, and syllabi are all represented. Minor gaps include lack of a direct single-section lookup, no search by instructor, and no registration/enrollment actions, but for a read-only catalog the core workflows are complete.
Maintenance
Related MCP Connectors
Discover, compare, route, and execute machine-accessible capabilities for AI agents.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
The Ferryhopper MCP server is a connector for LLMs and AI Agents in maritime travel that exposes ferry routes, schedules, and booking options. It enables AI assistants to search ports and connections across 33 countries and 190+ ferry operators, provide real-time ferry itineraries with indicative prices, and assist users with planning island-hopping or multi-leg journeys by processing natural language queries about ferry times, passenger counts, and travel durations.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables searching and retrieving course details, schedules, prerequisites, and instructor information from the CMU course catalog via the ScottyLabs API.92MIT
- FlicenseAqualityDmaintenanceEnables searching Brown University courses, getting detailed course info, and checking schedule conflicts via natural language, using the university's public course catalog API.5-
- FlicenseNot gradedqualityDmaintenanceProvides intelligent access to a university course catalog with full-text search, prerequisite tracking, instructor lookups, and course comparison prompts.-
- AlicenseAqualityBmaintenanceEnables searching and retrieving course listings, departments, and syllabi from National Chengchi University's public course API using natural language.31MIT