员工管理微服务

皮尔多拉斯德夫

项目 pildorasDev -用于管理员工的轻量级微服务 FastMCP y PostgreSQL。

主要特征

• 员工完整CRUD的工具（FASTMCP）： list_employees, add_employee, get_employee, update_employee, delete_employee.
• PostgreSQL（初始化脚本）中的持久性 init.sql).
• 用…遏制 Dockerfile 与编排 docker-compose.yml.

内容存储库

• main.py：实施上述工具。
• init.sql：创建表的脚本 employees 以及示例数据。
• pyproject.toml, uv.lock：依赖性和再现性锁定。
• Dockerfile, docker-compose.yml：部署服务和数据库的配置。

要求

• Python>=3.12
• PostgreSQL（如果不使用Docker）

快速使用（带码头）

1. 建设和提升服务：

docker compose up --build -d

2. 服务在港口展出 3000.

环境变量（示例 mcp-server)

• DB_HOST （en docker-compose.yml 使用主机连接到BD服务 postgres)
• DB_PORT (5432)
• DB_USER
• DB_PASSWORD
• DB_DATABASE

注： docker-compose.yml 山 init.sql 在BD的初始化中；检查文件本身中的变量。

本地执行（开发）-使用 uv （建议复制容器环境）：

1. 创建和激活虚拟环境：

python -m venv .venv
source .venv/bin/activate

2. 不稳定 uv 并同步依赖项 uv.lock:

pip install uv
uv sync --frozen --no-dev --no-cache

3. 运行服务（希望BD可用并配置环境变量）：

uv run python main.py

快速选择：使用 docker compose up --build -d 一起启动BD和服务。

如何使用工具

• list_employees(limit=10, offset=0) -准备分页。
• add_employee(name, position, department, salary, hire_date?) -插入员工。
• get_employee(employee_id) -通过以下方式获得员工 id.
• update_employee(employee_id, ...) -允许部分字段更新。
• delete_employee(employee_id) -通过删除员工 id.

发展说明

• main.py 美国 psycopg2.extras.RealDictCursor 返回字典等行（按列名访问）。
• 函数通过将错误封装在 RuntimeError 保持与服务跑步者的一致。

许可证 这个项目是根据麻省理工学院的许可证发布的-见 许可证.

联系方式 Autor：戈塔迪·梅洛https://github.com/Gottardy