关键词

学生信息学业数据大学HEMIS成绩课程表考勤学历证明

使用说明

项目简介

本项目 'MCP HEMIS Student' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在作为 Claude 等 LLM 应用访问高等教育管理信息系统 (HEMIS) 中学生信息的桥梁。通过该 MCP 服务器，学生可以通过自然语言指令，直接在 Claude 中查询和获取自己的学业相关信息。

主要功能点

  • 学生信息查询: 获取个人基本信息、学业信息、GPA 记录、学期信息等。
  • 成绩查询: 查询学期成绩、科目成绩、考试成绩、学业表现等。
  • 课程表查询: 获取个人课表、考试安排等。
  • 出勤查询: 查询个人考勤记录。
  • 文档与合同: 获取合同信息、学历证明、学生证明、 приказы 等官方文件。
  • 大学信息: 查询大学统计数据、大学结构、大学概况等公开信息。

安装步骤

  1. 安装 Claude for Desktop: 访问 https://claude.ai/download 下载并安装 Claude for Desktop 客户端。
  2. 安装 Python: 确保已安装 Python 3.10 或更高版本。
  3. 安装 uv: 按照 README.md 文件中的指引，根据你的操作系统安装 'uv' 包管理器。
    • macOS/Linux: 
      curl -LsSf https://astral.sh/uv/install.sh | sh
    • Windows (powershell): 
      powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  4. 克隆仓库: 使用 git 克隆 'mcp_hemis_student' 仓库到本地： 
    git clone https://github.com/sukhrobyangibaev/mcp_hemis_student.git
cd mcp_hemis_student

服务器配置

要使 Claude for Desktop 能够连接到 'mcp_hemis_student' 服务器，需要修改 Claude 的配置文件 'claude_desktop_config.json'。

  1. 找到配置文件: 根据你的操作系统，找到 'claude_desktop_config.json' 文件路径：

    • Windows: 'C:\Users\User\AppData\Roaming\Claude\claude_desktop_config.json'
    • Mac: '~/Library/Application Support/Claude/claude_desktop_config.json'

    注意: 如果文件不存在，请手动创建。

  2. 编辑配置文件: 将以下 JSON 配置添加到 'claude_desktop_config.json' 文件中的 '"mcpServers"' 字段下。如果 '"mcpServers"' 字段不存在，则创建它。

    {
    "mcpServers": {
        "hemis": {
            "command": "uv",  // 启动命令: 使用 uv 包管理器
            "args": [         // 命令参数: 传递给 uv 的参数
                "--directory",  // 指定工作目录参数
                "你的项目路径", // **请替换为你的 mcp_hemis_student 项目的绝对路径**，例如 "C:\\Users\\Sukhrob\\Documents\\Projects\\mcp_hemis_student"
                "run",        // uv 的 run 命令，用于运行 Python 脚本
                "server.py"   // 服务器启动脚本名称
            ],
            "env": {          // 环境变量: 服务器运行所需的环境变量
                "HEMIS_API_BASE": "https://student.ubtuit.uz/rest/v1/", // HEMIS API 基础 URL，通常无需修改
                "HEMIS_LOGIN": "你的HEMIS登录名",    // **请替换为你的 HEMIS 系统登录用户名**
                "HEMIS_PASSWORD": "你的HEMIS密码"   // **请替换为你的 HEMIS 系统登录密码**
            }
        }
    }
}

    警告:

    • 请务必将 'args' 中的 '"你的项目路径"' 替换为你本地 'mcp_hemis_student' 仓库的实际绝对路径。
    • 请务必将 'env' 中的 '"你的HEMIS登录名"' 和 '"你的HEMIS密码"' 替换为你自己的 HEMIS 系统登录凭据。

  3. 保存并重启: 保存 'claude_desktop_config.json' 文件，并重启 Claude for Desktop 客户端。

基本使用方法

  1. 检查连接: 重启 Claude for Desktop 后，如果配置正确，Claude 界面左侧的工具栏中会出现一个锤子图标，表示 MCP 服务器已成功连接。

  2. 使用命令: 在 Claude 的聊天输入框中，可以使用自然语言命令来查询学生信息。例如：

    • 'Show me my current GPA' (显示我的当前 GPA)
    • 'What classes do I have this week?' (我这周有哪些课程？)
    • 'Show me my attendance for Databases class' (显示我数据库课程的出勤)
    • 'What exams do I have this semester?' (我这学期有哪些考试？)

    更多可用命令请参考 README.md 文件中 "Available Tools" 部分的详细列表。

信息

分类

商业系统

访问项目