项目简介

本项目包含一个简单的基于 Model Context Protocol (MCP) 构建的服务器实现。该服务器专注于提供员工请假相关的上下文信息和操作功能,例如查询剩余假期天数、申请请假以及查看请假历史。它使用Python语言和FastMCP框架构建,通过标准化的MCP协议与兼容的LLM客户端进行通信。

主要功能点

  • 查询请假余额: 允许客户端查询指定员工剩余的请假天数。
  • 申请请假: 支持客户端为指定员工申请指定日期的请假,并自动更新假期余额和历史记录。
  • 查询请假历史: 提供查询指定员工所有请假记录的功能。
  • 获取个性化问候: 提供一个简单的资源,根据请求的名称返回个性化问候语。

安装步骤

  1. 克隆仓库: 将代码仓库克隆到本地计算机。
    git clone https://github.com/ItsMistahJi/Balaji_playwright.git
    cd Balaji_playwright
  2. 安装依赖: 确保您已安装Python环境。代码中使用了 'uv' 工具导入,建议使用 'uv' 或 'pip' 安装所需的 'mcp' 库。
    # 推荐使用 uv 安装
    uv pip install mcp
    
    # 或者使用 pip 安装
    pip install mcp

服务器配置(供MCP客户端参考)

此MCP服务器是为了与支持MCP协议的客户端(如某些LLM应用或框架)进行交互而设计的。客户端需要知道如何启动这个服务器进程并与其建立连接。

以下是客户端可能需要配置的关键信息描述:

  • 服务器名称 (Server Name): 'LeaveManager'
  • 启动命令 (Command): 'python'
  • 命令参数 (Args): '["MCP_server1/second_mcp_server/main.py"]' (假设客户端从仓库根目录启动命令)
    • 此参数列表告诉客户端运行 'python' 解释器,并执行位于 'MCP_server1/second_mcp_server/' 目录下的 'main.py' 脚本。

确切的配置方式取决于您使用的MCP客户端的具体实现,但通常会涉及提供上述服务器名称、启动命令和参数,以便客户端能够按需启动并连接到此服务器。

基本使用方法

此MCP服务器本身是作为后端服务运行的,不提供图形界面或命令行交互界面供用户直接使用。它旨在接收来自MCP客户端(如一个能够调用外部工具和资源的LLM)的请求。

一旦服务器启动并与客户端建立连接,客户端即可通过MCP协议调用服务器提供的工具和资源:

  • 客户端可以向服务器发送请求,调用 'get_leave_balance' 工具,并提供员工ID作为参数,以获取请假余额信息。
  • 客户端可以调用 'apply_leave' 工具,提供员工ID和请假日期列表作为参数,从而为员工申请请假。
  • 客户端可以调用 'get_leave_history' 工具,提供员工ID作为参数,以获取该员工的请假历史。
  • 客户端可以请求 'greeting://<name>' 形式的资源,服务器将返回包含指定名称的问候语。

服务器将处理这些请求,执行相应的逻辑(如更新内存中的请假数据),并通过MCP协议将结果返回给客户端。

信息

分类

商业系统