关键词

请假管理学生管理后端应用LLM工具上下文服务

项目简介

本项目是一个基于 FastMCP 库实现的 MCP 服务器，专注于学生请假跟踪管理。它通过 MCP 协议为 LLM 客户端提供了一系列工具（Tools）和资源（Resources），用于处理请假请求的提交、查询和状态更新。

主要功能点

  • 提交请假请求： 允许用户提交新的请假申请，包含日期和原因。
  • 查看请假历史： 查询特定学生的请假记录，支持按状态（待处理、已批准、已拒绝）过滤。
  • 查看所有请假： 获取系统中所有学生的全部请假请求数据。
  • 更新请假状态： 允许更新请假请求的状态，如批准或拒绝。
  • 提供问候语资源： 一个简单的 MCP 资源示例。

安装步骤

  1. 克隆仓库： 
    git clone <repository-url>
cd mcp-server # 仓库克隆后可能需要进入此目录
  2. 创建并激活虚拟环境： 
    python -m venv .venv
# Windows 用户
.venv\Scripts\activate
# Unix/MacOS 用户
source .venv/bin/activate
  3. 安装依赖： 确保 'requirements.txt' 文件存在，然后安装所需库。 
    pip install -r requirements.txt
    （所需依赖包括 'fastmcp>=1.0.0', 'python-dateutil>=2.8.2', 'typing-extensions>=4.5.0'）

服务器配置

此 MCP 服务器通过标准输入/输出 (Stdio) 协议与客户端通信。MCP 客户端需要以下信息来连接和启动此服务器进程：

  • 'server name': 'LeaveTracker' (此为服务器在初始化时设置的名称，或客户端自定义的易读名称)
  • 'command': 'python' (启动服务器的 Python 可执行文件路径)
  • 'args': '["main.py"]' (包含服务器实现的主文件路径)

例如，在一个 MCP 客户端的配置文件中，可能会有类似（但不是代码，这是配置的逻辑描述）：

{
  "name": "LeaveTracker",
  "transport": {
    "type": "stdio",
    "command": "python",
    "args": ["path/to/your/cloned/repository/main.py"]
  }
  // 其他配置...
}

基本使用方法

  1. 完成安装步骤。
  2. 在项目根目录下，运行以下命令启动 MCP 服务器： 
    python main.py
  3. 服务器启动后，它将通过 Stdio 协议等待 MCP 客户端的连接和 JSON-RPC 请求。LLM 客户端可以通过连接到此进程来利用服务器提供的工具和资源。

信息

分类

生产力应用

访问项目