跳至主要内容

DHTMLX Pivot MCP 服务器:配置、聚合和导出

DHTMLX Pivot 将一个配置对象转换为完全聚合的表格,并开放了整个第二套 API,即底层的 Table widget,用于导出数据或展开树形行。布局更改和完整表格重绘各自触发自己的事件:布局编辑触发其中一个,而底层的每一次重绘触发另一个。要做对这一切,靠的是最新文档,而不是过时的猜测。

不妨改为查询 DHTMLX MCP 服务器:它会返回当前的 config 结构通过 getTable() 的导出路径,以及用于持久化的正确事件,从而让助手生成的代码与 Pivot 当前实际的行为方式相匹配。

MCP 端点

https://docs.dhtmlx.com/mcp
备注

DHTMLX MCP 服务器覆盖了所有主要的 DHTMLX 产品,而不仅仅是 DHTMLX Pivot。无论您使用哪个 DHTMLX 组件进行开发,相同的端点和配置说明都同样适用。

Pivot 开发者向 MCP 服务器提出的问题

MCP 服务器几乎可以告诉您关于 DHTMLX Pivot 文档的一切,从以下内容开始:

Pivot 问题在 MCP 中的去向

发送到 DHTMLX MCP 服务器的 Pivot 问题会经过一条基于 Model Context Protocol(MCP)构建的检索增强生成(RAG)流水线,并落入两种工作流之一:Search,返回匹配的参考页面供助手据此编写代码;或 Inference,直接读取这些页面并自行回答问题。这类请求中只有一半需要查阅文档。助手会精确定位出这一半,其余部分(即特定于服务器的保存逻辑)则依靠自身已有的知识来编写。

以提示词 "编写一个处理程序,在每次布局更改时将 Pivot 的 config 保存到服务器。" 为例:

  1. 助手划定出需要查阅文档的那一半:应监听哪个事件,以及如何读取当前的 config。
  2. 服务器定位到其映射的与服务器配合使用文档。
  3. 由于该请求需要生成代码,因此由 Search 处理(而更细化的问题,例如 render-table 是否比 update-config 触发得更频繁,则会交给 Inference 处理)。
  4. Search 从当前 Pivot 文档的向量索引中获取匹配的页面。
  5. 助手将这些页面作为上下文获取回来。
  6. 基于该上下文,助手编写 update-config 监听器,正确跳过触发更频繁的 render-table,然后依靠自身知识添加针对目标服务器的实际保存请求。

如此一来,Pivot 的聚合和导出代码便能始终与当前 API 保持一致。

将您的 AI 工具连接到 MCP 服务器

无论您在使用 Pivot 时搭配哪种 AI 开发工具,将其接入 MCP 服务器都只需一步:通过 CLI 命令或 JSON 配置文件,将其指向下面的端点 URL。

https://docs.dhtmlx.com/mcp

以下是常用工具的具体设置说明。

Claude Code

信息

Claude Code 的官方文档详细介绍了每一种 MCP 配置方式。

要通过命令行注册该服务器,请运行:

claude mcp add --transport http dhtmlx-mcp https://docs.dhtmlx.com/mcp

手头没有 CLI?请手动将以下配置添加到您的 .mcp.json 文件中:

{
"mcpServers": {
"dhtmlx-mcp": {
"type": "http",
"url": "https://docs.dhtmlx.com/mcp"
}
}
}

Cursor

信息

有关完整的 MCP 配置选项,请参阅 Cursor 的官方文档

添加服务器的步骤:

  1. 打开设置(Mac 上按 Cmd+Shift+J,Windows/Linux 上按 Ctrl+Shift+J
  2. 进入 Tools & MCP
  3. 点击 Add Custom MCP
  4. 粘贴以下 config:
{
"mcpServers": {
"dhtmlx-mcp": {
"url": "https://docs.dhtmlx.com/mcp"
}
}
}

Google Antigravity

Antigravity 2.0

信息

关于在 Antigravity 中集成 MCP 服务器的完整说明,请参阅官方文档

以下是将 DHTMLX MCP 服务器与 Google Antigravity 连接所需完成的步骤:

  1. 打开命令面板
  2. 输入 "mcp add"
  3. 选择 "HTTP"
  4. 提供以下值:
  • Name:
dhtmlx-mcp
  • URL:
https://docs.dhtmlx.com/mcp

Antigravity CLI

信息

相关指南说明了从 Gemini CLI 迁移到 Antigravity CLI 时会发生哪些变化。

要将 DHTMLX MCP 服务器连接到 Antigravity CLI,请在以下位置之一创建 mcp_config.json

  • 全局:~/.gemini/config/mcp_config.json
  • 工作区:.agents/mcp_config.json

添加以下配置:

{
"mcpServers": {
"dhtmlx-mcp": {
"serverUrl": "https://docs.dhtmlx.com/mcp"
}
}
}

然后在终端中运行 agy

ChatGPT

信息

有关在 ChatGPT 中设置 MCP 连接器的每一步操作,请参阅官方文档

配置连接器的步骤:

  1. 进入 SettingsApps & Connectors
  2. 点击 Advanced settings
  3. 启用 Developer mode
  4. 返回 Apps & Connectors 并点击 "Create"
  5. 填写连接器详情:
  • Name:
dhtmlx-mcp
  • URL:
https://docs.dhtmlx.com/mcp
  • Authentication:No authentication
  1. 点击 Create

创建连接器后,ChatGPT 会在对话过程中从 MCP 服务器提取文档。

信息

对于高强度的编码工作流,其他支持 MCP 的工具可能更合适。

其他工具

其他 AI 编码工具的设置面板通常将此功能称为 "Model Context Protocol" 或 "Context Sources"。请在其中将 https://docs.dhtmlx.com/mcp 添加为自定义源。

您的查询数据流向何处

作为一项托管服务,MCP 服务器从不在您的硬件上运行,从不打开本地文件,也从不存储个人信息。

服务器仅出于调试问题和改进服务的目的记录查询。

如需完全关闭查询日志记录,请申请商业部署。请联系 info@dhtmlx.com 进行安排。

让 Pivot 得到正确结果的提示词

一条提示词通常涉及四件事之一:config、聚合、布局或服务器同步。下面的分组会预先为您点明这一点。

Config 与聚合

How do I add a custom aggregation method in DHTMLX Pivot? Use the docs.
How do I set a default sort order for a field in DHTMLX Pivot?
What's the difference between the two accepted forms of a values entry in the config property?

谓词与字段

How do I group date values by month using a custom predicate in DHTMLX Pivot?
How do I apply a currency format with a dollar-sign prefix to a numeric field?

布局与样式

How do I freeze the first two row fields on the left in DHTMLX Pivot?
How do I enable tree mode in DHTMLX Pivot and choose which field becomes the parent row?
How do I change the hover color for primary buttons in the Material theme?

服务器同步与导出

How do I save the user's layout to a server whenever they change it?
How do I export the Pivot table to XLSX?

Pivot 提示词写作小贴士

  • 说明您指的是哪个 API。 export、树形行的展开/折叠以及按行筛选,都是通过 getTable() 返回的 Table 实例运行的,而不是直接通过 Pivot 实例。明确指出这一层级,可以避免助手在错误的对象上调用仅 Table 才有的方法。
  • 区分方法与谓词。 聚合方法(sumcount,或 methods 中的自定义条目)用于汇总已存在于某行或某列中的值。谓词则在分组发生之前对原始值进行转换。请说明您的提示词针对的是哪个阶段。
  • 明确说明您想要的 values 条目形式。 values 条目可以是 "method(field)" 字符串,也可以是 { field, method } 对象。明确说明您使用的形式,可以避免助手臆造出第三种结构。
  • 在询问 update-configrender-table 的区别时,加上一句 "Use the docs"。 这两个事件的触发频率不同,而这正是过时训练数据容易忽略的那类细节。