Babson Engage MCP 서버

Babson Engage(CampusGroups/Anthology 기반)를 통해 AI 에이전트가 Babson의 캠퍼스 이벤트 및 학생 단체 정보에 접근할 수 있도록 하는 MCP 서버입니다. 실시간 RSS 피드와 과거 iCal 데이터를 병합하여 150개 이상의 이벤트를 통합 검색 가능한 타임라인으로 제공합니다.

Babson AI Fellowship(2026년 봄)을 위해 5월 4일 결과물에 대한 인프라로 구축되었으며, 내부 Babson 데이터 소스를 NavAI와 같은 AI 에이전트를 위한 MCP 호환 데이터 계층으로 변환하는 방법을 보여줍니다.

라이브 배포

현재 두 서비스 모두 수동 deploy.zip 업로드를 통해 배포됩니다. 푸시 투 디플로이(push-to-deploy) 방식으로 전환하기 위한 IT 인수인계 가이드는 아래의 "GitHub Actions로 마이그레이션" 섹션을 참조하십시오.

데이터 소스

위 세 가지 모두 공개 엔드포인트이며, 인증이 필요하지 않습니다.

도구

search-events

모든 Babson Engage 이벤트(과거 및 예정)에 대한 통합 검색을 수행합니다. RSS와 iCal 피드를 병합하고 중복을 제거한 뒤 정렬된 타임라인을 반환합니다.

매개변수:

• query (선택 사항) -- 제목, 설명, 위치, 그룹에 대한 키워드 검색

• category (선택 사항) -- 카테고리별 필터링 (CAREER, INDUSTRY, SOCIAL, ENTREPRENEURSHIP, COMMUNITY, CULTURAL, ANNOUNCEMENT)

• from_date (선택 사항) -- 시작 날짜 (YYYY-MM-DD). 기본값: 90일 전

• to_date (선택 사항) -- 종료 날짜 (YYYY-MM-DD). 기본값: 30일 후

• food_only (선택 사항) -- 음식이 제공되는 이벤트만 필터링

• limit (선택 사항) -- 최대 결과 수 (기본값 20, 최대 100)

get-event-detail

Engage 이벤트 ID를 사용하여 특정 이벤트의 전체 세부 정보를 가져옵니다. RSS 이벤트만 해당됩니다(예정된 이벤트가 iCal 과거 기록보다 더 풍부한 데이터를 가짐).

매개변수:

• event_id -- Engage 이벤트 ID

list-groups

활동 중인 학생 동아리 및 단체 목록을 나열합니다. 이름/미션 키워드 또는 그룹 유형별로 필터링할 수 있습니다.

매개변수:

• search (선택 사항) -- 이름 또는 미션에 대한 키워드 필터

• group_type (선택 사항) -- 유형별 필터링 (예: "Graduate Club", "Organization")

• limit (선택 사항) -- 최대 결과 수 (기본값 30, 최대 100)

리소스

• engage://events -- 모든 예정된 이벤트의 전체 JSON 스냅샷

• engage://groups -- 모든 활동 중인 그룹의 전체 JSON 스냅샷

아키텍처

• 캐싱: 5분 TTL을 가진 인메모리 캐시. RSS/iCal에 접근할 수 없는 경우 이전 데이터를 반환합니다.

• 중복 제거: RSS와 iCal 모두에 나타나는 이벤트는 제목과 날짜를 기준으로 병합되며, 더 풍부한 정보를 가진 RSS 기록을 우선합니다.

• 카테고리 매핑: 18개의 CampusGroups 이벤트 유형을 일관된 필터링을 위해 7개의 카테고리로 매핑했습니다.

• 전송: Stdio (표준 MCP). Claude Code에 의해 관리되는 로컬 프로세스로 실행됩니다.

설정

npm install
npm run build

Claude Code와 함께 사용하기

프로젝트 루트의 .mcp.json에 추가하십시오:

{
  "mcpServers": {
    "babson-engage": {
      "command": "node",
      "args": ["/path/to/engage-mcp-server/dist/server.js"]
    }
  }
}

개발

npm run dev  # runs with tsx

예시 쿼리

• "이번 주에 어떤 커리어 이벤트가 있나요?" -- search-events(category: "CAREER", from_date: "2026-04-07", to_date: "2026-04-14")

• "무료 음식이 제공되는 이벤트가 있나요?" -- search-events(food_only: true)

• "2월에 Babson에서 무슨 일이 있었나요?" -- search-events(from_date: "2026-02-01", to_date: "2026-02-28")

• "기술 동아리 찾아줘" -- list-groups(search: "tech")

기술 스택

• TypeScript + Node.js

• @modelcontextprotocol/sdk -- MCP 서버 프레임워크

• fast-xml-parser -- RSS/XML 파싱

• zod -- 입력 유효성 검사

GitHub Actions로 마이그레이션 (IT 인수인계 가이드)

현재 MCP 서버와 데모 모두 Azure에 수동 deploy.zip 업로드를 통해 배포됩니다. 저장소에는 .github/workflows/ 내에 두 개의 즉시 사용 가능한 GitHub Actions 워크플로우가 포함되어 있으며, 활성화되기 전까지는 .example 확장자로 비활성 상태입니다.

MCP 서버 자동 배포 활성화 (Azure App Service)

1. 게시 프로필 가져오기. Azure 포털 → App Service babson-engage-mcp → 개요 → "게시 프로필 가져오기" (.PublishSettings XML 다운로드).

2. GitHub에 추가. 저장소 → 설정 → Secrets and variables → Actions → AZURE_WEBAPP_PUBLISH_PROFILE이라는 이름의 새 저장소 시크릿 생성. XML 전체 내용을 붙여넣기.

3. 워크플로우 활성화. .github/workflows/azure-app-service-deploy.yml.example의 이름을 .github/workflows/azure-app-service-deploy.yml로 변경하고 커밋. 이제 main 브랜치에 푸시할 때마다 MCP 서버가 빌드 및 배포됩니다.

데모 자동 배포 활성화 (Azure Static Web Apps)

1. 배포 토큰 가져오기. Azure 포털 → 데모용 Static Web App → "배포 토큰 관리" → 복사.

2. GitHub에 추가. 저장소 → 설정 → Secrets → AZURE_STATIC_WEB_APPS_API_TOKEN이라는 이름의 새 저장소 시크릿 생성. 토큰 붙여넣기.

3. 워크플로우 활성화. .github/workflows/azure-static-web-app-deploy.yml.example의 이름을 .github/workflows/azure-static-web-app-deploy.yml로 변경하고 커밋. demo/** 경로를 수정하는 푸시가 발생하면 데모가 재배포됩니다.

활성화 후: MCP 서버는 푸시당 약 5분, 데모는 약 30초 소요됩니다. 수동 deploy.zip 단계는 더 이상 필요하지 않습니다.

사용자 지정 도메인 (선택 사항, Babson IT 필요)

위의 Azure URL은 자동 생성된 것입니다. Babson IT에서 engage-mcp.babson.edu(또는 유사한 도메인)를 원할 경우 5분 내에 설정 가능합니다:

1. IT 부서에서 engage-mcp.babson.edu에서 babson-engage-mcp.azurewebsites.net으로 CNAME 레코드 추가

2. Azure 포털 → App Service → 사용자 지정 도메인 → "사용자 지정 도메인 추가" → CNAME 확인, 무료 Azure 관리 인증서 연결. Static Web App 데모도 동일한 패턴을 따릅니다.