# Kingdee K3Cloud (Cloud Galaxy) ERP

> Kingdee K3Cloud (Cloud Galaxy) ERP is an open-source MCP server for finance and payments. Unofficial MCP server that lets AI assistants work in Kingdee K3Cloud ERP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://wahailong.github.io/KingdeeMCP/
- **Repository:** https://github.com/wahailong/kingdeemcp
- **MCP Registry name:** io.github.WaHaiLong/kingdee-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

The server logs in to a Kingdee K3Cloud instance with a dedicated account through the official WebAPI (ValidateUser), so the assistant can only do what that account is allowed to do. Credentials are passed as four environment variables: server URL (ending in /k3cloud/), account set ID, user name and password.

It bundles 101 tools across 17 business areas, including production, costing, assets, audit, purchasing, sales, inventory, bill attachments, finance, subcontracting and financial reports. There are also four SQL Server inspection tools for searching tables and fields, and metadata helpers that cache form definitions locally. Sessions are re-established automatically and failed connections are retried.

The project says it is third-party and open source and is not affiliated with Kingdee. It runs over stdio from PyPI (`uvx kingdee-mcp`) and can also be started in SSE or streamable HTTP mode or in Docker for remote use; the Kingdee login is still required in those modes. Documentation is in Chinese.

## Features

- **101 ERP tools:** Covers 17 domains from production and costing to purchasing, sales, inventory and financial reports.
- **Bill create and audit:** Can save bills and audit or un-audit them in batches, as well as query purchase orders, sales orders and stock.
- **Metadata discovery:** Lets the agent list forms and fields and fetch bill templates, with form metadata cached locally.
- **SQL Server probes:** Four extra tools search tables and fields and suggest Kingdee metadata candidates.
- **Auto retry and re-login:** Expired sessions trigger a new login and failed connections are retried.
- **Remote deployment:** Can run over SSE or streamable HTTP, or from a Docker image, besides local stdio.

## Good for

- Check purchase order or stock status in natural language during ERP implementation
- Batch audit inbound documents instead of clicking through the ERP
- Explore form structures and fields while building custom integrations
- Let business staff run their own inventory and order lookups
- Demonstrate live ERP data to a client during a rollout

## Install

### Claude Code (Terminal)

```sh
claude mcp add kingdee-mcp --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
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kingdee-mcp": {
      "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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kingdee-mcp": {
      "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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kingdee-mcp": {
      "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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kingdee-mcp": {
      "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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kingdee-mcp": {
      "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>"
      }
    }
  }
}
```

## Tools

- `kingdee_query_purchase_orders`: Query purchase orders with a filter, sort and row limit.
- `kingdee_query_inventory`: Query inventory by material number.
- `kingdee_query_sale_orders`: Query sales orders with a filter.
- `kingdee_save_bill`: Save a bill for a given form ID.
- `kingdee_audit_bills`: Audit bills by ID for a given form.
- `kingdee_unaudit_bills`: Reverse the audit of bills.
- `kingdee_list_forms`: List available forms.
- `kingdee_get_fields`: Show the fields of a form.
- `get_bill_template`: Fetch a bill template.
- `validate_bill`: Validate a bill before saving.
- `refresh_metadata`: Refresh the locally cached metadata.

## FAQ

### Is this an official Kingdee product?

No. The README says it is third-party open source with no affiliation or authorization from Kingdee.

### What do I need to connect?

A K3Cloud server URL ending in /k3cloud/, an account set ID, and a user name and password. A dedicated integration account is recommended instead of Administrator.

### Does it need an app ID or secret?

No. It signs in with ValidateUser account and password, so no third-party app authorization is required.

### Can it run on a server instead of my laptop?

Yes. It supports SSE and streamable HTTP modes and a Docker image, though the SQL Server probe tools need an additional ODBC driver in the container.

### Is Kingdee K3Cloud (Cloud Galaxy) ERP free?

Yes. Kingdee K3Cloud (Cloud Galaxy) ERP is open source, so you can use and self-host it for free.

### How do I add Kingdee K3Cloud (Cloud Galaxy) ERP to Claude Code?

Run this command in your terminal: claude mcp add kingdee-mcp --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

### What are the best alternatives to Kingdee K3Cloud (Cloud Galaxy) ERP?

The closest alternatives to Kingdee K3Cloud (Cloud Galaxy) ERP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/kingdee-k3cloud-cloud-galaxy-erp
