Skip to main content
Glama
bluewms

dingjie-erp-mcp

by bluewms

MCPHub ERP 部署项目

通过 Docker Compose 一键部署 MCPHub + 多个 ERP MCP Server,让 AI 助手通过自然语言操作鼎捷、金蝶、Odoo 等 ERP 与 MES、WMS 系统。

目录结构

mcphub-erp/
├── docker-compose.yml          # mcphub + PostgreSQL 启动配置
├── .env.example                # 环境变量模板(复制为 .env)
├── .env                        # 实际环境变量(不进 Git)
├── .gitignore
├── README.md                   # 本文档
└── mcp-servers/                # 各 ERP MCP Server 源码(挂载进容器)
    ├── dingjie-mcp-sever/      # 鼎捷 ERP E10 MCP
    ├── kingdee-k3cloud-mcp-main/  # 金蝶 K3Cloud MCP
    └── mcp-odoo/               # Odoo MCP

Related MCP server: ECOUNT MCP Server

架构原理

你的本机 (IDE 编辑代码)
    │
    ▼  docker -v 挂载
┌─────────────────────────────────────────┐
│  mcphub 容器 (samanhappy/mcphub:latest) │
│  内置 uv + node 22                      │
│                                         │
│  /app/mcp-servers/  ← 挂载的源码        │
│    ├── dingjie-mcp-sever/               │
│    ├── kingdee-k3cloud-mcp-main/        │
│    └── mcp-odoo/                        │
│                                         │
│  Dashboard (端口 3000)                  │
│    └─ uv run --directory ... 启动 MCP   │
└─────────────────────────────────────────┘
              │
              ▼
         PostgreSQL (配置持久化)

核心优势:代码挂载进容器,改代码后在 Dashboard 点 reload 即可生效,无需重新构建镜像。

快速开始

1. 配置环境变量

cp .env.example .env

编辑 .env,填写各 ERP 的连接信息(必填项见文件内注释)。

2. 配置 Odoo(如使用)

Odoo 通过 JSON 配置文件连接,不走环境变量:

cp mcp-servers/mcp-odoo/odoo_config.json.example mcp-servers/mcp-odoo/odoo_config.json

编辑 odoo_config.json

{
  "url": "https://your-odoo-instance.com",
  "db": "your-database-name",
  "username": "your-username",
  "password": "your-password-or-api-key"
}

3. 启动服务

docker compose up -d

首次启动会拉取镜像并初始化数据库,约 1-2 分钟。

4. 访问管理面板

打开浏览器访问 http://localhost:3000,使用 .env 中设置的 ADMIN_PASSWORD 登录。

5. 添加 MCP Server

在 Dashboard → Servers 页面,按下方配置逐个添加。

MCP Server 配置

重要:mcphub 会将容器环境变量自动注入每个 MCP Server 子进程。 因此下方的 env 只需填写需要覆盖的值,ERP 凭证已在 .env 中统一配置。

鼎捷 ERP E10

字段

名称

dingjie-e10

类型

stdio

command

uv

args

run --directory /app/mcp-servers/dingjie-mcp-sever dingjie-erp-mcp

env

{}(凭证已从容器环境继承)

金蝶 K3Cloud

字段

名称

kingdee-k3cloud

类型

stdio

command

uv

args

run --directory /app/mcp-servers/kingdee-k3cloud-mcp-main kingdee-k3cloud-mcp

env

{}

Odoo

字段

名称

odoo

类型

stdio

command

uv

args

run --directory /app/mcp-servers/mcp-odoo odoo-mcp

env

{}

JSON 批量导入

也可在 Dashboard → Import → 粘贴以下 JSON 一次性导入全部三个:

{
  "mcpServers": {
    "dingjie-e10": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/app/mcp-servers/dingjie-mcp-sever", "dingjie-erp-mcp"]
    },
    "kingdee-k3cloud": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/app/mcp-servers/kingdee-k3cloud-mcp-main", "kingdee-k3cloud-mcp"]
    },
    "odoo": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/app/mcp-servers/mcp-odoo", "odoo-mcp"]
    }
  }
}

导入后在各 Server 的 Env 标签页确认凭证已从容器继承,无需重复填写。

更新代码

改完任意 MCP Server 代码后:

  1. 保存文件(IDE 直接编辑 mcp-servers/ 下的源码)

  2. 打开 Dashboard → Servers

  3. 对应 Server 点 reload(重载图标)

  4. uv run --directory 会用挂载目录里的最新代码重启 → 立即生效

无需 docker compose build、无需重新部署。

常用命令

# 启动
docker compose up -d

# 查看日志
docker compose logs -f mcphub

# 停止
docker compose down

# 停止并删除数据卷(⚠️ 清空所有配置)
docker compose down -v

# 更新 mcphub 镜像
docker compose pull && docker compose up -d

内网/离线部署

如容器无法访问公网 PyPI,可在 .env 中设置内网镜像:

# 取消 docker-compose.yml 中对应行的注释,或在 .env 中设置
UV_DEFAULT_INDEX=https://pypi.your-company.com/simple/
npm_config_registry=https://npm.your-company.com/

mcphub 会在启动 uv/uvx/python 命令的 Server 时自动注入 UV_DEFAULT_INDEX

环境变量说明

变量

说明

默认值

MCPHUB_PORT

管理面板端口

3000

ADMIN_PASSWORD

首次启动管理员密码

mcphub2024

DB_PASSWORD

PostgreSQL 密码

mcphub_password

DB_PORT

PostgreSQL 端口

5432

DINGJIE_*

鼎捷互联中台连接参数

KD_*

金蝶 K3Cloud 连接参数

MCP_MODE

全局模式:readonly / readwrite

readwrite

完整变量列表见 .env.example

关于 Git 管理

本仓库将 mcp-servers/ 下的各 MCP Server 源码一并纳入 Git,便于:

  • 单仓库部署git clone 即可获得完整运行环境

  • 版本锁定:所有 ERP 接口代码与部署配置同步版本管理

  • 团队协作:同事 clone 后填入 .env 即可启动

如果各 MCP Server 有独立远程仓库且希望保持同步,可改用 Git Submodule:

git submodule add <repo-url> mcp-servers/dingjie-mcp-sever

许可证

本部署配置遵循 MIT 协议。各 MCP Server 的许可证见各自目录。

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive interaction with ERPNext systems through natural language, providing secure access to any document type (customers, items, invoices, etc.) with enterprise-grade permission controls and audit logging.
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to interact with ECOUNT ERP through natural language, providing tools for products, inventory, sales, purchases, and more.
    23
    15
    3
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    Enables AI assistants to operate Kingdee Cloud Star ERP via natural language, including querying, creating, submitting, auditing, and deleting business documents.
    81
    76
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to query ERP sales data, including employees, sales, customers, and top products, through MCP tools.
    -