# Kingdee K3Cloud (Cloud Galaxy) ERP

Kingdee K3Cloud (Cloud Galaxy) ERP is an MCP server for Claude Code, with 101 tools for procurement, sales, inventory, and manufacturing workflows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 146 repo stars
- Author: WaHaiLong
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WaHaiLong/KingdeeMCP
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kingdee-k3cloud-cloud-galaxy-erp

## What it does

This server bridges assistants with the Kingdee K3Cloud (Cloud Galaxy) WebAPI. It implements 101 operational tools divided into 17 business areas. Assistants can create or audit business vouchers, look up stock balances, manage manufacturing batches, and push related documents through the pipeline. Four tools allow inspecting database tables and column definitions.

The service uses FastMCP alongside Pydantic data schemas. Network calls run asynchronously, and expired sessions trigger an automatic re-login. Beyond standard input-output mode, the server supports SSE and Streamable HTTP endpoints, with multi-stage Docker deployment available.

Authentication requires genuine user credentials via `ValidateUser` rather than AppID tokens, preserving strict data permission controls. The optional SQL Server inspection features will fail unless the host machine has Microsoft's `msodbcsql18` driver installed.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `KINGDEE_SERVER_URL`, `KINGDEE_ACCT_ID`, `KINGDEE_USERNAME`, `KINGDEE_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add kingdee-mcp -e KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> -e KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> -e KINGDEE_USERNAME=<KINGDEE_USERNAME> -e KINGDEE_PASSWORD=<KINGDEE_PASSWORD> -- uvx kingdee-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add kingdee-k3cloud-cloud-galaxy-erp --env KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> --env KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> --env KINGDEE_USERNAME=<KINGDEE_USERNAME> --env KINGDEE_PASSWORD=<KINGDEE_PASSWORD> -- uvx kingdee-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kingdee-k3cloud-cloud-galaxy-erp": {
            "command": "uvx",
            "args": [
                "kingdee-mcp"
            ],
            "env": {
                "KINGDEE_SERVER_URL": "<KINGDEE_SERVER_URL>",
                "KINGDEE_ACCT_ID": "<KINGDEE_ACCT_ID>",
                "KINGDEE_USERNAME": "<KINGDEE_USERNAME>",
                "KINGDEE_PASSWORD": "<KINGDEE_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kingdee-k3cloud-cloud-galaxy-erp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "kingdee-mcp"
            ],
            "env": {
                "KINGDEE_SERVER_URL": "<KINGDEE_SERVER_URL>",
                "KINGDEE_ACCT_ID": "<KINGDEE_ACCT_ID>",
                "KINGDEE_USERNAME": "<KINGDEE_USERNAME>",
                "KINGDEE_PASSWORD": "<KINGDEE_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KINGDEE_SERVER_URL=<KINGDEE_SERVER_URL> -e KINGDEE_ACCT_ID=<KINGDEE_ACCT_ID> -e KINGDEE_USERNAME=<KINGDEE_USERNAME> -e KINGDEE_PASSWORD=<KINGDEE_PASSWORD> kingdee-k3cloud-cloud-galaxy-erp uvx kingdee-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kingdee-mcp <command>

## When to use it
- query approved procurement records and production schedules
- batch approve or roll back warehouse inventory receipts
- inspect ERP database tables and verify field definitions
- draft and validate sales orders via the official WebAPI

## Example prompts
- List all approved purchase orders created this month
- Create a draft sales order using these product line items
- Inspect the column metadata for the production orders table

## Similar
- [Olist Tiny ERP](https://affpapa.org/en/nevibecode/mcp/olist-tiny-erp.md) — MCP server · 302 installs
- [Frihet ERP](https://affpapa.org/en/nevibecode/mcp/frihet-erp.md) — MCP server · ★ 13 repo stars
- [erp-integration-analysis](https://affpapa.org/en/nevibecode/skills/erp-integration-analysis.md) — skill · 117 installs
- [ERP Facts](https://affpapa.org/en/nevibecode/mcp/erp-facts.md) — MCP server
- [tres-erp-rule-suggestions](https://affpapa.org/en/nevibecode/skills/tres-erp-rule-suggestions.md) — skill · ★ 4931 repo stars
- [tally-erp](https://affpapa.org/en/nevibecode/plugins/tally-erp.md) — plugin · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
