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配置。

## 联系支持

如有问题，请查看项目文档或联系开发团队。