返回 MCP 目录
public公开dns本地运行

EduMCPServer

这是一个与微软教育API集成的自定义MCP服务器项目,支持通过Claude Desktop等工具管理课程、作业、评分等功能。

article

README

🚀 📚 微软教育 MCP 服务器

本项目是一个自定义的模型上下文协议 (MCP) 服务器,主要用于与微软图谱 API集成,服务于教育领域。它能让Claude Desktop或其他兼容MCP的工具对微软教育课程、作业、评分量表、学生和教师信息等进行管理,专为AI驱动工具、测试和智能提示集成而打造。

🚀 快速开始

此项目是一个个人项目,与微软或其维护团队无任何关联。它是一个自定义的模型上下文协议 (MCP) 服务器,可与微软图谱 API 集成用于教育,能让Claude Desktop等兼容 MCP 的工具管理多项教育相关内容。

✨ 主要特性

  • 🔐 微软委托身份验证(通过MSAL的OAuth)
  • 🧑🏫 课程及花名册探索
  • 📝 作业创建、更新和学生指定
  • 🎓 评分量表创建和重复使用
  • 📤 查看作业提交及结果
  • 🧠 设计用于Claude Desktop及模型上下文客户端

📦 安装指南

文档未提及具体安装步骤,暂不提供。

💻 使用示例

基础用法

以下为表现不佳学生的辅导流程示例,这是一个基于原始提示的数据分析和后续指导的结构化演练。

原始提示

  1. 找到我代数课程中的作业“线性方程”。给我名称、说明和截止日期。
  2. 我想以表格形式概述所有表现不佳的学生。我要他们的姓名、我提供的反馈以及关联的评分量表(如果有)。每个学生一行,将评分量表分开列出。
  3. 能否分析评分量表反馈并找到共同点。
  4. 基于此反馈,有什么一些辅导的想法吗?
  5. 我想让他们练习不同类型的题目。
  6. 将其转化为一个作业和评分量表。
  7. 为这些学生创建一个新的草稿作业,包含这些信息…… 给他们两周时间完成它。

每个提示作为一个更大自动化或AI辅助教育工作流程的步骤:

  • 获取目标作业
  • 分析与评分量表对齐的反馈
  • 识别学习成果中的模式
  • 推荐学习干预措施
  • 创建和分配个性化辅导任务

📚 详细文档

📂 结构

🔍 关键组件

  • start-mcp-server.js
    • 加载并注册所有工具。
    • 通过MSAL管理微软身份验证。
    • 使用模型上下文协议SDK启动MCP服务器。
  • tools/ 文件夹
    • 每个文件定义一组相关工具并在服务器上注册它们。
    • 工具遵循MCP标准(server.tool(...))并使用Zod模式验证和微软图谱集成。
  • .env
    • 存储敏感的微软应用凭证和配置。
    • 需要用于与微软图谱API认证。
  • Example.env
    • 分享或协作伙伴使用的安全模板。

这种布局使以下操作变得容易:

  • 添加或修改功能(只需在tools/中添加一个文件)
  • 按领域保持逻辑分离(例如,作业 vs 评分量表)
  • 支持清洁和可扩展的MCP服务器

🔧 技术细节

文档未提及具体技术细节,暂不提供。

📄 许可证

文档未提及许可证信息,暂不提供。

⚠️ 重要提示

这是一个个人项目。它与微软或其维护团队没有任何关联。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端