鼎捷 ERP MCP Server

English | 中文

鼎捷 ERP E10 MCP Server，让 AI 助手（Claude Desktop、Claude Code、Cursor、Cline、OpenClaw 等任意支持 MCP 协议的客户端）通过自然语言查询和操作鼎捷 ERP 系统。

功能特性

• 20 个 MCP 工具：覆盖采购入库、销货出库、物料查询等核心操作
• 通用接口设计：统一的 CRUD + 审核操作模式
• 只读/读写模式：可限制 AI 只能查询，防止误操作
• 自动会话恢复：长时间运行时自动处理会话超时
• 多传输协议：支持 stdio（本地）、SSE、streamable-http（远程共享）
• 字段元数据：内置表单元数据查询，帮助 AI 正确构造参数

快速开始

方式一：uvx 直接运行（推荐）

# 设置环境变量
export DINGJIE_SERVER_URL=https://erp.company.com/
export DINGJIE_APP_ID=your_app_id
export DINGJIE_APP_SECRET=your_app_secret

# 启动 MCP Server
uvx dingjie-erp-mcp

方式二：从源码运行

git clone https://github.com/user/dingjie-erp-mcp.git
cd dingjie-erp-mcp
uv sync
uv run dingjie-erp-mcp

配置

复制环境变量模板并填写：

cp .env.example .env

环境变量	说明	示例
DINGJIE_SERVER_URL	鼎捷 ERP 服务器地址	https://erp.company.com/
DINGJIE_APP_ID	应用 ID	your_app_id
DINGJIE_APP_SECRET	应用密钥	your_app_secret
DINGJIE_ACCT_ID	账套 ID（可选）	your_acct_id
DINGJIE_USERNAME	用户名（可选）	your_username
DINGJIE_PASSWORD	密码（可选）	your_password
DINGJIE_TIMEOUT	请求超时（秒）	30
DINGJIE_VERIFY_SSL	是否验证 SSL	1
DINGJIE_LOCALE	语言	zh_CN
MCP_MODE	模式 (readonly/readwrite)	readwrite

客户端配置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "dingjie-erp": {
      "command": "uvx",
      "args": ["dingjie-erp-mcp"],
      "env": {
        "DINGJIE_SERVER_URL": "https://erp.company.com/",
        "DINGJIE_APP_ID": "your_app_id",
        "DINGJIE_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Claude Code

在项目目录下创建 .mcp.json：

{
  "mcpServers": {
    "dingjie-erp": {
      "command": "uvx",
      "args": ["dingjie-erp-mcp"],
      "env": {
        "DINGJIE_SERVER_URL": "https://erp.company.com/",
        "DINGJIE_APP_ID": "your_app_id",
        "DINGJIE_APP_SECRET": "your_app_secret"
      }
    }
  }
}

SSE 模式（远程共享）

DINGJIE_SERVER_URL=... \
DINGJIE_APP_ID=... \
DINGJIE_APP_SECRET=... \
MCP_API_KEY=your-mcp-key \
uvx dingjie-erp-mcp --transport sse --port 8080

可用工具

采购入库（7 个）

工具	说明
query_purchase_receipts	查询采购入库单列表
read_purchase_receipt	查看采购入库单详情
create_purchase_receipt	创建采购入库单
approve_purchase_receipt	审核采购入库单
disapprove_purchase_receipt	撤销审核采购入库单
delete_purchase_receipt	删除采购入库单
invalid_purchase_receipt	作废采购入库单

销货出库（7 个）

工具	说明
query_sales_issues	查询销货出库单列表
read_sales_issue	查看销货出库单详情
create_sales_issue	创建销货出库单
approve_sales_issue	审核销货出库单
disapprove_sales_issue	撤销审核销货出库单
delete_sales_issue	删除销货出库单
invalid_sales_issue	作废销货出库单

物料（2 个）

工具	说明
query_materials	查询物料列表
read_material	查看物料详情

通用（2 个）

工具	说明
health_check	检查 ERP 连接状态
query_metadata	查询表单元数据

只读模式

通过 --mode readonly 或 MCP_MODE=readonly 限制服务器只暴露查询工具：

"args": ["dingjie-erp-mcp", "--mode", "readonly"]

开发

git clone https://github.com/user/dingjie-erp-mcp.git
cd dingjie-erp-mcp
uv sync --dev

# 运行测试
uv run pytest

# 代码检查
uv run ruff check .
uv run mypy src

架构

详见 ARCHITECTURE.md 和 DEVELOPMENT_PLAN.md。

许可证

MIT License