HR MCP Server

HR MCP 服务

一个基于模型上下文协议（MCP）的 HR 操作服务，专为与 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

根据员工 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: "[email protected]", 
    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" 
})

翻译系统能够结合上下文处理 HR 专用术语，保留 “benefits”、“period”、“check”、“position” 等词语的技术含义；这些词语在人力资本管理语境中具有特殊含义。

安装

# 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

2. 通过选择 “Local Tool (via 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

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

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

本软件按“原样”提供，不附带任何形式的明示或默示保证，包括但不限于对适销性、特定用途适用性和不侵权的保证。在任何情况下，作者或版权所有者均不对因本软件或本软件的使用或其他处理而产生的任何索赔、损害或其他责任承担责任，无论该责任是基于合同、侵权还是其他原因。