@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.

MCP Tools

This server provides the following MCP tools:

1. listTickets: List all pending approval tickets
2. approve: Approve specified tickets
3. takeScreenshot: Take a screenshot of the current browser state

License

MIT