跳至主要内容

DHTMLX To Do List MCP 服务器:任务、项目与 REST 同步

DHTMLX To Do List 表面上看只是一份简单的清单,实际上却集成了嵌套子任务优先级快捷键拖放排序基于话题标签的筛选,以及一个通过 Event Bus 串联的 REST 后端。要让生成的代码真正可用,就需要复制任务将任务缩进为子任务的当前方法签名、正确的事件载荷结构,以及当下确实存在的任务字段选项,而不是过时的训练记忆。

DHTMLX MCP 服务器正是为此而生:它让助手在作答之前先查阅最新的 To Do List 文档。将它指向任务操作多选与批量操作REST 后端集成任务与项目配置,助手便会检索当前的 API,而不是凭猜测作答。

MCP 端点

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

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

To Do List API 的 MCP 服务器支持范围

服务器的索引覆盖了完整的 DHTMLX To Do List 文档,其中包括:

To Do List 问题在 MCP 服务器中的流转过程

向 DHTMLX MCP 服务器提出任何与 To Do List 相关的问题时,请求都会经由 Model Context Protocol (MCP) 进入一条 Retrieval-Augmented Generation (RAG) 流水线。随后由两种工作流之一接手:Search 返回匹配的参考页面,供助手据此撰写答案;而 Inference 则直接阅读这些页面并给出回答。一个 To Do List 请求往往包含两项彼此独立的工作:一项需要查阅最新文档,另一项助手自己就能完成。在任何内容进入 MCP 之前,助手会先把前者剥离出来。

以提示词*"如何确保添加任务和移动任务的操作按正确的顺序到达我的服务器?"*为例,整个流程如下:

  1. 助手识别出需要查阅文档的部分:如何通过 api.setNext() 将 RestDataProvider 接入 Event Bus。
  2. 服务器定位到该问题所属的服务器协作文档。
  3. 生成该处理程序需要输出代码,因此请求会交给 Search(若是范围更窄的问题,比如链中哪个事件先触发,则会交给 Inference)。
  4. Search 从基于当前 To Do List 文档构建的向量索引中取回匹配的页面。
  5. 这些页面作为上下文返回给助手。
  6. 助手根据这些上下文组装 Event Bus 的串联代码,再凭自身知识补全与具体服务器相关的请求细节,而无需对 To Do List API 进行猜测。

正因为有了这次查阅,助手才能按照当前实际的工作方式把 RestDataProvider 接入 Event Bus。

配置 MCP 连接

无论是搭建全新的 To Do List 项目,还是接入现有的 RestDataProvider 后端,起步方式都是一样的:把您的工具指向下面这个 URL,具体使用 CLI 命令还是 JSON 配置项,取决于该工具的要求。

https://docs.dhtmlx.com/mcp

以下各节将逐一介绍各款工具的配置方法。

Claude Code

信息

有关 Claude Code 中 MCP 配置的完整说明,请查阅官方文档

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

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

手动配置同样可行,只需将以下内容添加到您的 .mcp.json 中:

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

Cursor

信息

Cursor 的 MCP 分步配置说明请参阅官方文档

添加服务器的步骤如下:

  1. 打开 Settings(Mac 上为 Cmd+Shift+J,Windows/Linux 上为 Ctrl+Shift+J
  2. 进入 Tools & MCP
  3. 点击 Add Custom MCP
  4. 粘贴以下配置:
{
"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 编码工具同样支持 MCP,相应设置通常位于 "Model Context Protocol" 或 "Context Sources" 之类的标签下。在那里将 https://docs.dhtmlx.com/mcp 添加为自定义来源即可。

MCP 服务器如何处理您的数据

MCP 服务器是一项托管服务:不会在您的机器上运行任何程序,不会读取您环境中的任何文件,也不会存储任何个人用户数据。

出于调试和服务改进的目的,发送到服务器的查询可能会被记录。

如果贵组织需要更严格的保障,请写信至 info@dhtmlx.com 咨询关闭查询日志记录的商业部署方案。

可直接复制并调整的 To Do List 提示词

下面每一组都针对一类操作。复制其中的示例,并根据您自己的数据调整措辞即可。

任务与层级

How do I add a subtask under a specific task in DHTMLX To Do List?
How do I make a task become a subtask of the task directly above it? Use the docs.
How do I copy a task along with its subtasks and paste it into a different project?

项目

How do I switch to a different active project and move a task into it?
What happens to a project's tasks when I delete the project in DHTMLX To Do List?

选择与批量操作

How do I select several tasks and mark them all as complete at once in DHTMLX To Do List?
How do I delete all currently selected tasks at once? Use the docs.

服务器集成

How do I connect DHTMLX To Do List to my Node.js backend and load tasks on initialization?
How do I set up multiuser mode so task changes sync across clients in real time?

让 To Do List 提示词更精准

  • 写明具体的方法名。 DHTMLX To Do List 提供了若干组名称相近的方法(checkTask()/uncheckTask()indentTask()/unindentTask()hideCompletedTasks()/showCompletedTasks())。写明方法名,助手才能检索到正确的参考页面,而不是凭猜测填写参数。
  • 说明操作对象是任务、项目还是用户。 许多方法接收结构相似的、基于 id 的对象(例如 getTask()getProject())。指明操作对象可以把检索范围收窄到 API 中正确的部分。
  • 描述数据结构。 相比笼统的"一个任务",诸如"带子任务和截止日期的任务"或"分配给多名用户的任务"这类提示词能检索到更精确的文档。在准备待加载的数据或配置 taskShape 时,这一点尤为重要。
  • 在提示词中加上 "Use the docs"。 这句话会提示助手触发一次 MCP 查询,而不是仅凭训练数据作答。它在处理事件载荷(例如 open-menuedit-item)和 REST 后端接线时最为有用,因为这两者都会随版本发生变化。