Degree Dynamicweb MCP

程度动态eb-mcp

用于DynamicWeb10管理API的MCP（模型上下文协议）服务器。使Claude Code能够完全访问DynamicWeb项类型、字段、页面、段落和API发现，而无需接触DW管理UI。

工具

物品类型

领域

页面

段落

产品

dw_product_update 接受三个输入映射：

• fields -顶级产品字段（名称、默认价格、库存等）
• customFields -全局产品自定义字段值，由SystemName键入
• categoryFields -产品类别字段值，按SystemName键入

产品架构

管理PIM数据模型：产品类别（属性组）和产品字段（属性本身）。

文件

交付API（只读）

API发现

设置

1.获取DW API令牌

在DynamicWeb管理中，转到 设置>开发人员>API密钥 并创建具有完全访问权限的新密钥。

2.配置您的AI客户端

Claude Code

添加 .mcp.json 在您的项目中：

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Cursor

添加 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目）：

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

VS Code / GitHub Copilot

添加 .vscode/mcp.json 到您的项目（注意：使用 servers，不 mcpServers):

{
  "servers": {
    "dynamicweb": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Cline

通过Cline的MCP设置UI进行配置，或添加到其配置中：

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Zed

添加到Zed的 settings.json （注：用途 context_servers):

{
  "context_servers": {
    "dynamicweb": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Continue.dev

添加 ~/.continue/config.yaml:

mcpServers:
  - name: dynamicweb
    command: npx
    args:
      - -y
      - "@degree-as/dynamicweb-mcp"
    env:
      DW_BASE_URL: https://your-dw-instance
      DW_API_TOKEN: your-token

3.重新启动客户端

当您的AI客户端加载时，MCP服务器会自动启动。

本地开发

如果你想从源代码而不是已发布的包运行：

git clone https://github.com/Degree-AS/degree-dynamicweb-mcp.git
cd degree-dynamicweb-mcp
npm install
npm run build

然后使用 "command": "node", "args": ["/path/to/degree-dynamicweb-mcp/dist/index.js"] 在 .mcp.json.

字段类型别名

项目类型字段(dw_field_save, dw_itemtype_create)

创建字段时，您可以使用短别名而不是完整别名。NET类名：

任何满的。NET编辑器类名也被接受。使用 dw_field_types 从DW实例中发现所有可用的编辑器。

产品领域(dw_product_field_save)

产品字段使用不同的系统-整数 TypeId 从 FieldTypeAll，而不是编辑器类名：

数字TypeId也可以直接接受。使用 dw_product_field_type_list 从DW实例中获取实时列表。

建筑

src/
  index.ts          Entry point - reads config from env, registers tools
  client.ts         DwClient - HTTP client for Admin API, Update API, Delivery API
  utils.ts          Shared Zod helpers (jsonParam, numParam) and string helpers (pascal)
  tools/
    itemTypes.ts    Item type CRUD, fields, restrictions, settings, editor discovery
    pages.ts        Page and area management
    paragraphs.ts   Paragraph management (uses ParagraphNew + ParagraphSave)
    products.ts     Product CRUD, bulk discount, custom/category field value updates
    productSchema.ts Product categories and product field schema management
    files.ts        File and directory browsing
    delivery.ts     Read-only Delivery API
    discovery.ts    Swagger search, endpoint schema, raw API calls

DW API表面

DynamicWeb管理API有三种调用约定：

1. 管理员API (GET /admin/api/{Endpoint})-带有URL参数的查询
2. 命令API (POST /admin/api/{Endpoint})-突变 { Model: {...} } 身体。删除命令使用扁平体（无模型包装）。
3. 更新API (POST /Admin/Api/{Endpoint}?Query.Type={Type})-更新现有记录 { QueryData: {...}, model: {...} } 身体

DwClient 每种方法都有专门的方法： get(), post(), command(), update(), delivery().

发展

npm run dev      # Run with tsx (hot reload)
npm run build    # Compile TypeScript
npm run start    # Run compiled version

更改后，运行 npm run build 并重新启动Claude Code以获取新版本。