Babson Engage MCP 服务器

MCP 服务器，通过 Babson Engage（由 CampusGroups/Anthology 提供支持）使 AI 代理能够访问 Babson 的校园活动和学生组织。它将实时 RSS 源与历史 iCal 数据合并为一个包含 150 多个事件的统一、可搜索的时间线。

为 Babson AI Fellowship（2026 年春季）构建，作为 5 月 4 日交付成果的基础设施：演示如何将 Babson 内部数据源转换为适用于 NavAI 等 AI 代理的 MCP 兼容数据层。

实时部署

目前两者均通过手动上传 deploy.zip 进行部署。请参阅下方的“迁移至 GitHub Actions”以获取关于切换到“推送即部署”的 IT 交接指南。

数据源

以上三个均为公共端点，无需身份验证。

工具

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)

• “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 服务器和演示均通过手动上传 deploy.zip 到 Azure 进行部署。仓库在 .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 演示采用相同的模式。