HR MCP 服务器

一个用于 HR 运营的模型上下文协议 (MCP) 服务器，专为 Claude Desktop 设计。

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

概述

此服务器实现了 模型上下文协议，为 Claude 提供对员工数据和 HR 运营的结构化访问。

HR MCP 服务器使 Claude 能够：

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

有关详细的架构概述，请参阅 ARCHITECTURE.md。

工具

该服务器向 Claude 提供以下工具：

1. get_employee_info

检索有关特定员工的详细信息，包括个人详细信息、雇佣信息、技能、福利等。

// 示例用法：
get_employee_info({ employee_id: "E001" })

// 包含敏感信息：
get_employee_info({ employee_id: "E001", include_sensitive: true })

2. search_employees

通过各种条件搜索员工，并具有灵活的匹配选项。 支持按姓名、部门、技能、地点和许多其他字段进行搜索。

// 基本搜索：
search_employees({ 
  query: { department: "Engineering" } 
})

// 高级搜索：
search_employees({ 
  query: { 
    location: "Seattle", 
    performance_rating: 5 
  }, 
  options: { 
    sort_by: "hireDate", 
    output_format: "detailed" 
  } 
})

// 搜索包含敏感信息：
search_employees({ 
  query: { salary_min: 100000 }, 
  options: { include_sensitive: true } 
})

3. request_global_leave

为前往多个国家/地区的员工提交全球休假申请，包括审批链和合规性提醒。

// 基本请求：
request_global_leave({ 
  employee_id: "E002", 
  start_date: "2025-05-01", 
  end_date: "2025-05-15", 
  reason: "Family vacation", 
  countries: ["USA", "UK"] 
})

// 包含自定义联系信息：
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 术语。

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

翻译系统以上下文感知的方式处理 HR 专用术语，保留诸如“benefits”、“period”、“check”、“position”等术语的技术含义，这些术语在人力资本管理上下文中具有特殊含义。

安装

# 克隆存储库
git clone https://github.com/yourusername/hr-mcp-server.git
cd hr-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

用法

1. 启动服务器：

npm start

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

3. 通过 Claude 的界面访问员工数据和 HR 工具。

开发

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

要在开发模式下运行：

npx ts-node-esm src/index.ts

技术栈

• TypeScript
• Node.js
• @modelcontextprotocol/sdk - 用于 JavaScript/TypeScript 的 MCP SDK
• Zod - TypeScript 优先的模式验证

代码结构

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

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

许可证

MIT

版权所有 (c) 2024

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

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

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他方面，由本软件或本软件的使用或其他处理引起的、与之相关的或与之相关的。