项目简介
本项目包含一个简单的基于 Model Context Protocol (MCP) 构建的服务器实现。该服务器专注于提供员工请假相关的上下文信息和操作功能,例如查询剩余假期天数、申请请假以及查看请假历史。它使用Python语言和FastMCP框架构建,通过标准化的MCP协议与兼容的LLM客户端进行通信。
主要功能点
- 查询请假余额: 允许客户端查询指定员工剩余的请假天数。
- 申请请假: 支持客户端为指定员工申请指定日期的请假,并自动更新假期余额和历史记录。
- 查询请假历史: 提供查询指定员工所有请假记录的功能。
- 获取个性化问候: 提供一个简单的资源,根据请求的名称返回个性化问候语。
安装步骤
- 克隆仓库: 将代码仓库克隆到本地计算机。
git clone https://github.com/ItsMistahJi/Balaji_playwright.git cd Balaji_playwright - 安装依赖: 确保您已安装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协议将结果返回给客户端。
信息
分类
商业系统