Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Employee Management MCP Serversearch for employees with level 3 and active status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
员工管理系统 MCP Server
基于Model Context Protocol (MCP)的员工管理系统API代理服务器,为前端提供统一的MCP协议接口来调用后端员工管理API。
功能特性
🚀 完整的员工管理功能支持
🔧 基于MCP协议的标准化接口
🛡️ 完善的错误处理和重试机制
📝 详细的日志记录
⚙️ 灵活的配置管理
🔐 支持API认证
支持的API功能
员工管理
✅ 根据ID查询员工 (
get_employee_by_id)✅ 查询所有员工 (
get_all_employees)✅ 新增员工 (
add_employee)✅ 更新员工信息 (
update_employee)✅ 删除员工 (
delete_employee)✅ 条件搜索员工 (
search_employees)✅ 根据级别查询员工 (
get_employees_by_level)✅ 查询在职员工 (
get_active_employees)✅ 同步员工数据 (
sync_employees)
快速开始
1. 安装依赖
pip install -r requirements.txt2. 配置环境变量
复制环境变量示例文件并修改配置:
cp env.example .env编辑 .env 文件,配置后端API地址:
# 后端API配置
MCP_API_BASE_URL=http://localhost:100863. 启动服务器
python main.py服务器将在 localhost:8000 启动。
配置说明
环境变量
变量名 | 默认值 | 说明 |
| localhost | MCP服务器主机 |
| 8000 | MCP服务器端口 |
| 后端API基础URL | |
| 30 | API请求超时时间(秒) |
| - | API密钥(可选) |
| INFO | 日志级别 |
项目结构
mcp-server/
├── src/
│ ├── __init__.py
│ ├── server.py # MCP服务器主入口
│ ├── tools/ # MCP工具定义
│ │ ├── __init__.py
│ │ ├── api_proxy.py # API代理工具
│ │ └── base.py # 基础工具类
│ ├── models/ # 数据模型
│ │ ├── __init__.py
│ │ └── schemas.py # 请求响应模型
│ ├── config/ # 配置管理
│ │ ├── __init__.py
│ │ └── settings.py # 服务器配置
│ └── utils/ # 工具函数
│ ├── __init__.py
│ └── helpers.py # 辅助函数
├── main.py # 项目主入口
├── requirements.txt # 依赖管理
├── env.example # 环境变量示例
└── README.md # 项目文档使用示例
前端调用示例
// 查询所有员工
const result = await mcpClient.callTool("get_all_employees", {});
// 根据ID查询员工
const employee = await mcpClient.callTool("get_employee_by_id", {
userId: 1001
});
// 新增员工
const newEmployee = await mcpClient.callTool("add_employee", {
firstName: "三",
lastName: "张",
salary: 8000.0,
currency: "CNY",
birthdate: "1990-01-01",
isActive: true,
level: "3"
});开发指南
添加新的API工具
在
src/tools/api_proxy.py中添加新的工具方法在
get_all_tools()方法中注册新工具在
execute()方法中添加工具调用逻辑
自定义配置
可以通过环境变量或修改 src/config/settings.py 来自定义配置。
故障排除
常见问题
连接后端API失败
检查后端服务是否启动
确认API地址配置是否正确
检查网络连接
工具调用失败
查看服务器日志获取详细错误信息
检查请求参数格式是否正确
确认后端API返回格式
日志查看
服务器运行时会输出详细的日志信息,包括:
工具注册信息
API调用详情
错误和异常信息
许可证
MIT License
贡献
欢迎提交Issue和Pull Request来改进这个项目。 # mcp-server
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.