Provides integration with Personio's personnel management API, allowing access to HR data and operations based on the OpenAPI specification at https://api.apis.guru/v2/specs/personio.de/personnel/1.0/openapi.json
该项目是针对给定 OpenAPI URL 的 MCP（多代理对话协议）服务器 - https://api.apis.guru/v2/specs/personio.de/personnel/1.0/openapi.json ，使用 AG2 的MCP 构建器自动生成。
pip install -e ".[dev]"来安装依赖项。如果您没有使用 dev 容器，则可以手动运行此命令。uv ：该项目使用ruff进行 linting 和格式化，使用mypy进行静态类型检查，使用pytest进行测试。
要检查 linting 问题：
格式化代码：
这些命令也可以通过scripts/lint.sh脚本获得。
运行静态分析（mypy、bandit、semgrep）：
该脚本还在.pre-commit-config.yaml中配置为预提交钩子。
要运行覆盖测试：
这将运行 pytest 并生成覆盖率报告。如果需要合并报告和清理，可以使用：
该项目使用.pre-commit-config.yaml中定义的预提交钩子。要安装钩子：
每次提交之前钩子都会自动运行。
MCP 服务器可以通过mcp_server/main.py脚本启动。它支持多种传输模式（例如stdio 、 sse ）。
启动服务器（例如，在 stdio 模式下）：
可以使用环境变量来配置服务器：
CONFIG_PATH ：JSON 配置文件的路径（例如mcp_server/mcp_config.json ）。CONFIG ：包含配置的 JSON 字符串。SECURITY ：安全参数的环境变量（例如 API 密钥）。有关如何加载这些内容的详细信息，请参阅mcp_server/main.py中的if __name__ == "__main__":块。
tests/test_mcp_server.py文件演示了如何以编程方式启动服务器并与之交互以进行测试。
该项目使用 Hatch 进行构建和发布。要构建项目，请执行以下操作：
发布项目：
这些命令也可以通过scripts/publish.sh脚本获得。