sichengchen/ohio-state-mcp-server

OSU MCP Server

A comprehensive MCP (Model Context Protocol) server that provides access to The Ohio State University's content APIs across multiple campus services including transportation, academics, dining, recreation, libraries, events, and more.

Features

This server provides 50+ tools across 14 different service categories for LLMs:

Athletics

• get_athletics_all: Get information about all OSU athletics programs and schedules
• search_sports: Search for specific sports or teams
• get_sport_by_gender: Find sports programs by gender
• get_upcoming_games: Get upcoming games and events across all sports

Buildings

• get_buildings: Get information about all OSU buildings
• search_buildings: Search for buildings by name or building number
• get_building_details: Get detailed information about a specific building
• find_room_type: Find buildings with specific room types (lactation, sanctuary, wellness, gender inclusive restrooms)

Bus Transportation

• get_bus_routes: Get information about all OSU bus routes
• get_bus_stops: Get stops and route information for a specific bus line
• get_bus_vehicles: Get real-time vehicle locations for a specific route

Academic Calendar & Holidays

• get_academic_calendar: Get the academic calendar with important dates
• get_university_holidays: Get university holidays
• search_calendar_events: Search for specific events in the academic calendar
• get_holidays_by_year: Get holidays for a specific year

Classes

• search_classes: Search for OSU classes by keyword, subject, instructor, etc.

Campus Events

• get_campus_events: Get information about all campus events
• search_campus_events: Search for campus events by title or description
• get_events_by_tag: Find events by specific tags or categories
• get_events_by_location: Find events at a specific location
• get_events_by_date_range: Find events within a specific date range

Dining

• get_dining_locations: Get all OSU dining locations with basic information
• get_dining_locations_with_menus: Get dining locations with menu section information
• get_dining_menu: Get detailed menu items for a specific dining location section

University Directory & People Search

• get_university_directory: Get the university directory information
• search_people: Search for people in the OSU directory by first and/or last name

Food Trucks

• get_foodtruck_events: Get information about all food truck events on campus
• search_foodtrucks: Search for food trucks by name or cuisine type
• get_foodtrucks_by_location: Find food trucks at a specific location

Library Services

• get_library_locations: Get information about all OSU library locations
• search_library_locations: Search for library locations by name
• get_library_rooms: Get information about all available library study rooms
• search_library_rooms: Search for library study rooms by name or location
• get_rooms_by_capacity: Find library study rooms by capacity
• get_rooms_with_amenities: Find library study rooms with specific amenities

BuckID Merchants

• get_buckid_merchants: Get information about all merchants that accept BuckID
• search_merchants: Search for merchants by name or category
• get_merchants_by_food_type: Find merchants by food/cuisine type
• get_merchants_with_meal_plan: Find merchants that accept meal plans

Parking

• get_parking_availability: Get real-time parking availability for all OSU parking garages

Recreation Sports

• get_recsports_facilities: Get information about all OSU recreation sports facilities
• search_recsports_facilities: Search for recreation sports facilities by name
• get_facility_details: Get detailed information about a specific recreation facility
• get_facility_hours: Get current operating hours for all recreation facilities
• get_facility_events: Get scheduled events for recreation sports facilities

Student Organizations

• get_student_organizations: Get information about all student organizations
• search_student_orgs: Search for student organizations by name or keywords
• get_orgs_by_type: Find student organizations by type or category
• get_orgs_by_career_level: Find organizations for specific career levels

Installation

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

Usage

With Claude Desktop

Add this server to your Claude Desktop configuration file:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "osu": {
      "command": "node",
      "args": ["/path/to/ohio-state-mcp-server/build/index.js"]
    }
  }
}

Standalone Usage

You can also run the server directly:

npm start

Development

To run in development mode with automatic rebuilding:

npm run dev

API Information

This server uses The Ohio State University's content APIs.

License

MIT