dt_mcp 服务器 (决策树与任务管理 MCP 服务器)

该项目实现了一个基于 Node.js 的模型上下文协议（MCP）服务器，旨在管理和与定义在 .rtdq 文件中的决策树进行交互，并处理一个基本的待办事项列表。它使用 Redis 作为后端来存储解析后的 .rtdq 数据和待办事项列表。

功能

• RTDQ 处理：
  • 从指定目录加载 .rtdq 文件（v2.1 格式）。
  • 异步解析 .rtdq 文件。
  • 将解析后的决策树数据存储在 Redis 中。
  • 提供一个 MCP 工具 (get_dt_node_from_redis) 以从已加载的树中检索特定节点。
• 待办事项管理：
  • 提供 MCP 工具 (add_todo, list_todos, mark_todo_done) 来管理简单的待办事项列表。
  • 将待办事项存储在 Redis 中。
• MCP 集成：
  • 作为一个标准的 MCP 服务器运行。
  • 通过 /mcp 端点上的 HTTP 服务器发送事件 (SSE) 进行通信。
  • 通过标准的 MCP tools/list 和 tools/call 方法公开功能。

先决条件

• Node.js (推荐 v16+ 以支持 ES 模块和顶级 await)
• npm (或 yarn)
• 正在运行并可访问的 Redis 服务器

设置

1. 克隆仓库：

   git clone <your-repo-url>
   cd dt-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 配置环境：
   在项目根目录创建一个 .env 文件（并将其添加到 .gitignore），或者设置环境变量：

   • REDIS_URL: 你的 Redis 服务器的连接 URL（例如，redis://localhost:6379）。默认为 redis://localhost:6379。
   • RTDQ_DIR: (可选) 包含你的 .rtdq 文件的目录的绝对路径。默认为项目内的 rtdq_files 子目录。
   • PORT: (可选) 服务器监听的端口。默认为 3000。

4. 创建 RTDQ 目录：
   确保由 RTDQ_DIR 指定的目录（或默认的 rtdq_files 子目录）存在。将你的 .rtdq 文件放入其中。

运行服务器

npm start