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: MCP Server for Odoo

架构原理

你的本机 (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 的许可证见各自目录。

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bluewms/mcphub-erp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server