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 服务器。
  • 通过 HTTP Server-Sent Events (SSE) 在 /mcp 端点上进行通信。
  • 通过标准的 MCP tools/list 和 tools/call 方法公开功能。

前提条件

• Node.js (推荐 v16+，以支持 ES Modules 和顶层 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