Yongyou NC HR MCP Connector

MCP server connecting Claude/Cowork to the Yongyou NC HR module (NC Cloud / NC6+).

Exposes 9 tools for HR operations: employee master data, org structure, attendance, compensation, recruitment, and workflow approval.

Architecture

Claude/Cowork (MCP Client)
        |
        | JSON-RPC 2.0 over stdio
        v
yongyou-nc-hr-mcp (this server)
  - McpServer (tool definitions)
  - NcClient  (NC REST API wrapper)
        |
        | HTTP/HTTPS
        v
Yongyou NC Server (NC Cloud)
  - HR Module REST API

Prerequisites

Node.js 18+ (with native fetch)
Running Yongyou NC server with REST API enabled
NC username/password with HR module access

Installation

cd yongyou-nc-hr-mcp
npm install
cp .env.example .env
# Edit .env with your NC_BASE_URL, NC_USERNAME, NC_PASSWORD

Usage

Standalone test:

node src/index.js

Cowork integration

Add to your .mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "yongyou-nc-hr": {
      "command": "node",
      "args": ["path/to/yongyou-nc-hr-mcp/src/index.js"],
      "env": {
        "NC_BASE_URL": "http://your-nc-server:8080",
        "NC_USERNAME": "admin",
        "NC_PASSWORD": "your-password"
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | nc_hr_login | Authenticate with NC system | | search_employees | Search employee master data | | get_employee_info | Full employee details | | get_org_structure | Department hierarchy | | get_attendance_data | Attendance records | | get_compensation_data | Salary by period | | get_recruitment_status | Recruitment pipeline | | submit_approval | Submit workflow approval | | query_approval_status | Check approval progress |

Project Structure

yongyou-nc-hr-mcp/
  src/
    index.js      # MCP server entry
    nc-client.js  # NC REST API client
    config.js     # Environment config
  .env.example    # Config template
  package.json
  README.md

MCP Servers