Employee Management MCP Server

# 员工管理MCP服务器使用说明 ## 概述 这是一个基于MCP (Model Context Protocol) 的员工管理系统服务器，提供了丰富的员工管理功能。 ## 启动服务器 ### 方法1: 直接启动 ```bash cd /Users/ywt/PycharmProjects/mcp/src python server.py ``` ### 方法2: 使用测试客户端 ```bash cd /Users/ywt/PycharmProjects/mcp python test_client.py ``` ## 可用功能 ### 1. 查看所有员工 - **命令**: `list` - **描述**: 获取系统中所有员工的列表 - **示例**: 在客户端中输入 `list` ### 2. 根据ID查询员工 - **命令**: `get <员工ID>` - **描述**: 根据员工ID获取详细信息 - **示例**: `get 1` ### 3. 添加新员工 - **命令**: `add <名字> <姓氏> <工资> <级别>` - **描述**: 添加新的员工到系统 - **示例**: `add 张三 李四 5000 中级` ### 4. 搜索员工 - **命令**: `search <姓氏>` - **描述**: 根据姓氏搜索员工 - **示例**: `search 李` ### 5. 查看在职员工 - **命令**: `active` - **描述**: 获取所有在职状态的员工 - **示例**: `active` ### 6. 根据级别查询员工 - **命令**: `level <级别>` - **描述**: 根据员工级别查询员工 - **示例**: `level 高级` ### 7. 同步员工数据 - **命令**: `sync` - **描述**: 从JSON文件同步员工数据到数据库 - **示例**: `sync` ## 与AI助手集成 MCP服务器可以与支持MCP协议的AI助手（如Claude Desktop）集成。配置方法： ### 1. 配置Claude Desktop 在Claude Desktop的配置文件中添加： ```json { "mcpServers": { "employee-management": { "command": "python", "args": ["/Users/ywt/PycharmProjects/mcp/src/server.py"], "env": {} } } } ``` ### 2. 自然语言交互示例 配置完成后，你可以直接与Claude对话： - "帮我查看所有员工" - "添加一个新员工，名字叫张三，姓氏叫李四，工资8000，级别是高级" - "搜索姓氏为'王'的所有员工" - "显示所有在职员工" - "查看所有高级员工" ## 技术架构 ### 服务器端 - **框架**: MCP (Model Context Protocol) - **语言**: Python 3.11+ - **通信**: stdio (标准输入输出) ### 工具列表 1. `get_employee_by_id` - 根据ID查询员工 2. `get_all_employees` - 查询所有员工 3. `add_employee` - 新增员工 4. `update_employee` - 更新员工信息 5. `delete_employee` - 删除员工 6. `search_employees` - 条件搜索员工 7. `get_employees_by_level` - 根据级别查询员工 8. `get_active_employees` - 查询在职员工 9. `sync_employees` - 同步员工数据 ## 故障排除 ### 常见问题 1. **服务器启动失败** - 检查Python环境和依赖包 - 确保在正确的目录下运行 2. **客户端连接失败** - 确保服务器正在运行 - 检查路径配置是否正确 3. **工具调用失败** - 检查API服务是否可用 - 查看服务器日志获取详细错误信息 ### 日志查看 服务器会输出详细的日志信息，包括： - 工具注册状态 - 请求处理过程 - 错误信息 ## 开发说明 ### 添加新工具 1. 在 `src/tools/api_proxy.py` 中添加工具定义 2. 在 `execute` 方法中添加处理逻辑 3. 重启服务器 ### 修改API配置 编辑 `src/config/settings.py` 文件来修改API配置。 ## 联系支持 如有问题，请查看项目文档或联系开发团队。