@nickxiao42/kingdee-approval NPM

@nickxiao42/kingdee-approval

A Model Context Protocol server for Kingdee EAS OA approval automation.

Prerequisites

Node.js >= 18.0.0
Google Chrome installed

Usage

Using npx (Recommended)

Run directly without installation:

npx @nickxiao42/kingdee-approval --host=your.kingdee.host.com

Global Installation

# Install globally
npm install -g @nickxiao42/kingdee-approval

# Then run
kingdee-approval --host=your.kingdee.host.com --cred=username:password

Cursor MCP Configuration

To use this server with Cursor, add the following configuration to your .cursor/mcp-config.json:

{
  "mcpServers": {
    "kingdee": {
      "command": "npx",
      "args": [
        "@nickxiao42/kingdee-approval",
        "--host=your.kingdee.host.com",
        "--cred=username:password"
      ]
    }
  }
}

Replace:

your.kingdee.host.com with your Kingdee EAS host
username:password with your credentials

The configuration will allow Cursor to: 1. Automatically start the MCP server when needed 2. Use npx to ensure you always have the latest version 3. Provide the necessary host and credentials

Options

--host=hostname: Required. The Kingdee EAS host URL
--cred=user:pass: Optional. Login credentials in format "username:password"
--head: Optional. Run browser in headed mode (visible browser UI)
--test: Optional. Run in test mode (only executes login and listTickets)
--chrome=path: Optional. Path to Chrome executable

Environment Variables

KINGDEE_HOST: Alternative to --host argument
KINGDEE_CREDENTIAL: Alternative to --cred argument, format: "username:password"
KINGDEE_CHROME: Alternative to --chrome argument, path to Chrome executable

Default Chrome Paths

The server will look for Chrome in the following locations by default:

macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
Windows: C:\Program Files\Google\Chrome\Application\chrome.exe or C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
Linux: /usr/bin/google-chrome

If Chrome is installed in a different location, use the --chrome option or KINGDEE_CHROME environment variable to specify the correct path.