horizondatawave_hdw-mcp-server

🚀 HDW 命令行工具文档

HDW（Human Database Worker）是一款强大的命令行工具，专门用于管理人力资源数据。它能轻松实现用户、公司、项目和职位信息的创建、查询、更新和删除操作，为人力资源管理提供高效解决方案。

🚀 快速开始

完成安装后，您可以通过以下命令快速开始：

hdw --version

✨ 主要特性

• 全面的数据管理：支持对用户、公司、项目和职位信息进行创建、查询、更新和删除操作。
• 数据导入导出：可以将数据库中的数据导出为 CSV 文件，也能从 CSV 文件中导入数据到数据库。
• 多模式支持：既可以使用本地数据库，也可以连接远程数据库。

📦 安装指南

安装步骤

1. 下载安装包：从官方网站或指定镜像站点下载适用于您操作系统的 HDW 安装包。
2. 解压并安装：在选择的目录下解压安装包，执行安装程序，按照提示完成安装过程。
3. 配置环境变量：将 HDW 的可执行文件路径添加到系统环境变量中，以便从命令行直接调用 HDW 命令。
4. 初始化数据库：运行 hdw init 命令，初始化本地数据库并创建必要的表结构。
5. 连接远程数据库（可选）：如果需要使用远程数据库，请配置数据库连接信息，并运行 hdw connect 命令建立连接。

💻 使用示例

基础用法

用户管理

• 创建用户

# 创建一个新的用户
hdw create-user <username> <password> <email>

示例：

hdw create-user john doe123 john@example.com

• 更新用户资料

# 更新用户资料
hdw update-user --url <user_url> [--new-name <name>] [--email <email>] [--phone <phone>]

示例：

hdw update-user --url http://example.com/john --new-name John Doe --email john@example.com --phone 1234567890

• 删除用户

# 删除指定的用户
hdw delete-user <user_url>

示例：

hdw delete-user http://example.com/john

公司管理

• 创建公司

# 创建新的公司信息
hdw create-company <name> <industry> <size>

示例：

hdw create-company Tech Corp IT 500

• 更新公司信息

# 更新公司的详细信息
hdw update-company --company-id <id> [--new-name <name>] [--new-industry <industry>] [--new-size <size>]

示例：

hdw update-company --company-id TC123 --new-name Advanced Tech Corp --new-industry AI --new-size 1000

• 删除公司

# 删除指定的公司信息
hdw delete-company <company_id>

示例：

hdw delete-company TC123

项目管理

• 创建项目

# 创建新的项目条目
hdw create-project <name> <description> <start-date> <end-date>

示例：

hdw create-project Space Mission "Mars exploration project" 2024-01-01 2025-12-31

• 更新项目信息

# 更新项目的详细信息
hdw update-project --project-id <id> [--new-name <name>] [--new-description <description>] [--new-start-date <start-date>] [--new-end-date <end-date>]

示例：

hdw update-project --project-id SM123 --new-name Moon Base --new-description "Lunar exploration project" 2024-07-01 2026-12-31

• 删除项目

# 删除指定的项目条目
hdw delete-project <project_id>

示例：

hdw delete-project SM123

职位管理

• 创建职位

# 创建新的职位信息
hdw create-job <title> <description> <salary> <location>

示例：

hdw create-job Data Scientist "AI research position" "100000-150000" "New York, NY"

• 更新职位信息

# 更新职位的详细信息
hdw update-job --job-id <id> [--new-title <title>] [--new-description <description>] [--new-salary <salary>] [--new-location <location>]

示例：

hdw update-job --job-id DS123 --new-title Senior Data Scientist --new-description "Machine learning research" 150000-200000 "San Francisco, CA"

• 删除职位

# 删除指定的职位条目
hdw delete-job <job_id>

示例：

hdw delete-job DS123

高级用法

数据导出与导入

• 导出数据

# 将数据库中的所有用户、公司、项目和职位信息导出为 CSV 文件
hdw export-data --output <output-file>

示例：

hdw export-data --output hdw_export.csv

• 导入数据

# 从 CSV 文件中导入数据到数据库
hdw import-data --input <input-file>

示例：

hdw import-data --input hdw_import.csv

附录

错误代码

| 错误代码 | 详情 | | ---- | ---- | | 1 | 成功 | | 2 | 参数错误 | | 3 | 数据库连接失败 | | 4 | 权限不足 | | 5 | 资源不存在 | | 6 | 内部服务器错误 | | 7 | 输入数据无效 |

示例命令

• 创建新用户：

create_new_user --username "john" --password "doe123" --email "john@example.com"

• 更新用户资料：

update_user_profile --url "http://example.com/john" --new_name "John Doe" --email "john@example.com" --phone "1234567890"

• 导出用户数据为 CSV：

export_user_data --url "http://example.com/john" --output_file "user_export.csv"

• 删除用户：

delete_user --url "http://example.com/john"

• 创建新公司：

create_new_company --name "Tech Corp" --industry "IT" --size "500"

• 更新公司信息：

update_company_info --company_id "TC123" --new_name "Advanced Tech Corp" --new_industry "AI" --new_size "1000"

• 删除公司：

delete_company --company_id "TC123"

• 创建新项目：

create_new_project --name "Space Mission" --description "Mars exploration project" --start_date "2024-01-01" --end_date "2025-12-31"

• 更新项目信息：

update_project_info --project_id "SM123" --new_name "Moon Base" --new_description "Lunar exploration project" --new_start_date "2024-07-01" --new_end_date "2026-12-31"

• 删除项目：

delete_project --project_id "SM123"

• 创建新职位：

create_new_job --title "Data Scientist" --description "AI research position" --salary "100000-150000" --location "New York, NY"

• 更新职位信息：

update_job_info --job_id "DS123" --new_title "Senior Data Scientist" --new_description "Machine learning research" --new_salary "150000-200000" --new_location "San Francisco, CA"

• 删除职位：

delete_job --job_id "DS123"