Slate MCP服务器
连接的MCP(模型上下文协议)服务器 技术解决方案板 使用Claude,您可以通过自然语言查询和分析学生入学人口统计数据。
特性
- 入学人口统计:获取即将入学班级的全面人口统计摘要
- 多样性指标:计算多样性指数、URM百分比和地理多样性
- 招生漏斗:跟踪从潜在客户到注册客户的转化率
- 同比比较:分析多个注册年份的趋势
- 灵活的查询:按各种条件搜索和筛选学生
先决条件
- Node.js 18.0.0或更高版本
- 使用API凭据访问Technolutions Slate实例
- 为注册数据配置的Slate查询(请参阅 板岩配置)
安装
# Clone the repository
git clone https://github.com/your-org/slate-mcp-server.git
cd slate-mcp-server
# Install dependencies
npm install
# Build the project
npm run build配置
环境变量
复制 .env.example 到 .env 并配置您的Slate凭据:
cp .env.example .env所需的环境变量:
| 变量 | 描述 |
|---|---|
SLATE_BASE_URL | 您的Slate实例URL(例如。, https://yourschool.technolutions.net) |
SLATE_USERNAME | Slate API用户名 |
SLATE_PASSWORD | Slate API密码 |
SLATE_API_KEY | (可选)如果实例使用基于密钥的身份验证,则使用API密钥 |
Claude桌面配置
将服务器添加到Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"slate": {
"command": "node",
"args": ["/path/to/slate-mcp-server/dist/index.js"],
"env": {
"SLATE_BASE_URL": "https://yourschool.technolutions.net",
"SLATE_USERNAME": "your_username",
"SLATE_PASSWORD": "your_password"
}
}
}
}板岩配置
此MCP服务器希望在您的Slate实例中配置某些查询。与您的Slate管理员合作创建以下查询:
必填查询
enrollment_demographics:返回已注册学生的人口统计数据
- 必填字段: id, first_name, last_name, email, gender, ethnicity, race, citizenship, first_generation, state, country, intended_major, entry_year, entry_term, enrollment_status
enrollment_funnel:返回漏斗计数
- 必填字段: prospects, inquiries, applicants, admitted, deposited, enrolled
students_by_status:返回按申请状态筛选的学生
- 必填字段:与 enrollment_demographics
查询参数
服务器将把这些参数传递给您的查询:
entry_year:入学年份(例如2024年)entry_term:报名期限(例如“秋季”)application_status:用于基于状态的查询
可用工具
get_enrollment_demographics
获取注册学生的全面人口统计摘要。
参数:
entry_year(必填):入职年份(例如2024年)entry_term(可选):输入术语(默认值:“Fall”)
示例提示: “给我看看2024年秋季新生的人口统计数据”
get_diversity_metrics
获取详细的多样性指标,包括多样性指数和URM百分比。
参数:
entry_year(必填):入职年份entry_term(可选):进入期限
示例提示: “我们2024届新生的多样性指标是什么?”
get_enrollment_funnel
获取包含转化率的注册漏斗数据。
参数:
entry_year(必填):入职年份entry_term(可选):进入期限
示例提示: “给我看看2024年秋季的入学漏斗和收益率”
compare_enrollment_years
比较多年的人口统计数据。
参数:
years(必填):要比较的年份数组(例如,\[2022、2023、2024\])entry_term(可选):进入期限
示例提示: “比较2022年至2024年的入学人口统计数据”
get_demographics_report
生成格式化、可读的人口统计报告。
参数:
entry_year(必填):入职年份entry_term(可选):进入期限
示例提示: “生成2024年秋季人口统计报告”
get_demographics_by_category
按特定类别获取注册明细。
参数:
entry_year(必填):入职年份category(必填):以下之一:gender,ethnicity,state,country,admit_type,major,college,first_generation,internationalentry_term(可选):进入期限
示例提示: “显示2024年秋季各州的入学情况”
search_students
搜索符合特定条件的学生。
参数:
entry_year(可选):按进入年份筛选entry_term(可选):按条目筛选state(可选):按家庭状态筛选country(可选):按母国筛选major(可选):按预期专业筛选first_generation(可选):按第一代状态过滤international(可选):按国际身份筛选limit(可选):最大结果(默认值:100)
示例提示: “查找2024年秋季来自加利福尼亚州的所有第一代学生”
对话示例
获取年度人口统计报告
User: What does our incoming Fall 2024 class look like demographically?
Claude: I'll pull the enrollment demographics for Fall 2024...
[Uses get_enrollment_demographics tool]
Here's a summary of your Fall 2024 incoming class:
- Total Enrolled: 2,450 students
- Gender: 54% Female, 45% Male, 1% Non-binary
- First Generation: 28% (686 students)
- International: 12% (294 students)
...同比分析
User: How has our diversity changed over the past 3 years?
Claude: I'll compare the demographics across 2022, 2023, and 2024...
[Uses compare_enrollment_years tool]
Here's the year-over-year comparison:
- First Generation: 24% → 26% → 28% (+4 points)
- International: 10% → 11% → 12% (+2 points)
- URM: 22% → 24% → 26% (+4 points)
...发展
# Run in development mode
npm run dev
# Type check
npm run typecheck
# Lint
npm run lint
# Build
npm run build安全考虑
- 永不承诺
.env包含凭据的文件 - 尽可能使用只读API凭据
- 服务器对搜索结果中的个人身份信息进行匿名处理
- 考虑对生产使用实施限速
许可证
麻省理工学院
支持
对于此MCP服务器的问题,请打开GitHub问题。
有关Slate的具体问题,请联系 技术支持.
