Metadata-Version: 2.4
Name: kingdee-mcp-ierp
Version: 0.1.0
Summary: Kingdee Cloud K/3 MCP Server for sales order and manufacturing order queries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: openpyxl>=3.1.0

# kingdee-mcp-ierp

An MCP server for Kingdee Cloud K/3 queries, packaged for `uvx`.

## Features

- Query sale orders
- Query manufacturing orders
- Query SO-MO relations
- Query delivery risk
- Query material shortage
- Export SO-MO Excel report

## Local Run

```bash
uvx --from . kingdee-mcp-ierp
```

## Environment Variables

Set these environment variables before starting the server:

```powershell
$env:KINGDEE_BASE_URL = "https://your-host/ierp/kapi"
$env:KINGDEE_CLIENT_ID = "your-client-id"
$env:KINGDEE_CLIENT_SECRET = "your-client-secret"
$env:KINGDEE_USERNAME = "your-username"
$env:KINGDEE_ACCOUNT_ID = "your-account-id"
$env:KINGDEE_LANGUAGE = "zh_CN"
```

Required variables:

- `KINGDEE_BASE_URL`
- `KINGDEE_CLIENT_ID`
- `KINGDEE_CLIENT_SECRET`
- `KINGDEE_USERNAME`
- `KINGDEE_ACCOUNT_ID`

Optional variables:

- `KINGDEE_LANGUAGE` (defaults to `zh_CN`)

You can copy `.env.example` as a local reference, but do not commit your real credentials.

```powershell
Copy-Item .env.example .env
```

## Trae MCP Config

You can also copy `.mcp.json.example` and fill in your own values.

```json
{
  "mcpServers": {
    "kingdee": {
      "command": "uvx",
      "env": {
        "KINGDEE_BASE_URL": "https://your-host/ierp/kapi",
        "KINGDEE_CLIENT_ID": "your-client-id",
        "KINGDEE_CLIENT_SECRET": "your-client-secret",
        "KINGDEE_USERNAME": "your-username",
        "KINGDEE_ACCOUNT_ID": "your-account-id",
        "KINGDEE_LANGUAGE": "zh_CN"
      },
      "args": [
        "--from",
        "C:\\Users\\ying\\AppData\\Roaming\\Python\\Python312\\site-packages\\kingdee_mcp_uvx_pkg",
        "kingdee-mcp-ierp"
      ]
    }
  }
}
```
