AI导哈

HR MCP服务器

一个用于HR操作的模型上下文协议服务器，提供员工信息查询、员工搜索、全球休假请求管理和HR/HCM上下文感知的文本翻译功能。

  • by gabrielrojasnyc
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 gabrielrojasnyc/hr-mcp-server

使用说明

HR MCP服务器

用于人力资源操作的模型上下文协议（MCP）服务器，专为与Claude Desktop一起使用而构建。

https://github.com/user-attachments/assets/4cb89115-daf2-4647-81d2-aadd9e0dd29e

概述

此服务器实现 模型上下文协议 为克劳德提供对员工数据和人力资源运营的结构化访问。

HR MCP服务器使Claude能够：

  • 查找详细的员工信息
  • 按各种条件搜索员工
  • 提交和管理全球休假申请
  • 具有HR/HCM上下文意识的文本翻译

有关详细的体系结构概述，请参见 建筑.md.

工具

服务器为Claude提供以下工具：

1. get_employee_info

按ID检索特定员工的详细信息，包括个人详细信息、就业信息、技能、福利等。

// Example usage:
get_employee_info({ employee_id: "E001" })

// With sensitive information:
get_employee_info({ employee_id: "E001", include_sensitive: true })

2. search_employees

通过灵活的匹配选项按各种标准搜索员工。支持按姓名、部门、技能、位置和许多其他字段进行搜索。

// Basic search:
search_employees({ 
  query: { department: "Engineering" } 
})

// Advanced search:
search_employees({ 
  query: { 
    location: "Seattle", 
    performance_rating: 5 
  }, 
  options: { 
    sort_by: "hireDate", 
    output_format: "detailed" 
  } 
})

// Search with sensitive information:
search_employees({ 
  query: { salary_min: 100000 }, 
  options: { include_sensitive: true } 
})

3. request_global_leave

为前往多个国家的员工提交全球休假申请，并附上审批链和合规提醒。

// Basic request:
request_global_leave({ 
  employee_id: "E002", 
  start_date: "2025-05-01", 
  end_date: "2025-05-15", 
  reason: "Family vacation", 
  countries: ["USA", "UK"] 
})

// With custom contact info:
request_global_leave({ 
  employee_id: "E002", 
  start_date: "2025-05-01", 
  end_date: "2025-05-15", 
  reason: "Family vacation", 
  countries: ["USA", "UK"], 
  contact_info: { 
    email: "bob.vacation@example.com", 
    phone: "+1-555-123-4567" 
  } 
})

4.翻译提示： translate_text

通过自动源语言检测和特别关注HR/HCM术语，将文本从任何语言翻译成指定的目标语言。

// Basic translation:
translate_text({ 
  text: "Les employés doivent soumettre leurs feuilles de temps avant la fin de la période.", 
  target_language: "English" 
})

翻译系统以语境意识处理人力资源特定术语，保留了“福利”、“期限”、“检查”、“职位”等术语的技术含义，这些术语在人力资本管理语境中具有特殊含义。

安装

# Clone the repository
git clone https://github.com/yourusername/hr-mcp-server.git
cd hr-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

用法

  1. 启动服务器：
npm start

  1. 通过选择“本地工具（通过stdio）”作为工具类型并使用服务器启动脚本的路径，将Claude Desktop连接到服务器。

  2. 通过Claude的界面访问员工数据和人力资源工具。

发展

  • 源代码在 /src 目录
  • 员工数据存储在 /src/data/employees.ts
  • 服务器使用具有严格类型的TypeScript

要在开发模式下运行：

npx ts-node-esm src/index.ts

技术栈

编码结构

服务器的组织重点是干净、可维护的代码：

  • 集中化的日志 -一致的JSON-RPC格式日志记录
  • 基于工具的架构 -每个工具都有明确的责任
  • 架构验证 -使用Zod对所有输入进行强打字
  • 错误处理 -具有清晰错误消息的全面验证
  • 文档 -解释复杂逻辑的内联注释

许可证

麻省理工学院

版权所有（c）2024

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

相关 MCP