关键词

待办事项管理任务跟踪大语言模型工具后端服务文件存储

这是一个基于Model Context Protocol (MCP)实现的待办事项管理后端服务。它允许兼容MCP协议的大语言模型（LLM）客户端（如Claude Code）通过标准化的方式与你的个人待办事项列表进行交互和管理。

主要功能点

  • 创建任务: 允许LLM为你添加新的待办事项，可包含优先级和项目分配。
  • 跟踪任务: LLM可以查询你的待办列表，查看所有待处理、进行中或已完成的任务。
  • 更新任务: LLM可以修改任务的状态（如标记为完成）、优先级或内容。
  • 过滤任务: 支持按状态、优先级、项目或关键词搜索任务。
  • 组织任务: 任务可以按项目进行分组存储和管理。
  • 持久化存储: 待办事项列表存储在用户主目录下的特定JSON文件中，确保数据持久性。

安装步骤

  1. 确保你的系统已安装 Node.js 和 npm。

  2. 克隆或下载该仓库到本地。

  3. 打开终端，切换到项目根目录。

  4. 运行以下命令安装依赖：

    npm install

服务器配置 (供MCP客户端参考)

MCP客户端需要知道如何启动并连接到此服务器。通常，这涉及到在客户端配置中指定服务器的可执行命令和参数。

以下是配置此MCP服务器所需的核心信息（具体配置方式取决于你的MCP客户端）：

{
  "serverName": "Claude Todo API", // 服务器名称，客户端通常以此识别
  "command": "node",              // 启动服务器进程的命令
  "args": [                       // 传递给命令的参数数组
    "./src/run-todo-server.js"    // 启动todo MCP服务器的主脚本路径
  ]
  // 可能还有其他配置，如 transport (通常默认为 stdio) 等
}

请注意，'command' 和 'args' 中的路径应该是相对于MCP客户端启动目录而言，或者使用绝对路径。'./src/run-todo-server.js' 指向仓库中的启动脚本。

基本使用方法

  1. 首先，按照安装步骤设置好项目。

  2. 在终端中，切换到项目根目录，运行服务器：

    npm start
# 或者
npm run todo

    服务器启动后，会监听标准输入/输出 (stdio) 端口，等待MCP客户端连接。

  3. 配置你的MCP客户端（如兼容MCP的LLM应用或开发工具），使其使用上面提供的配置信息来启动并连接到这个服务器。

  4. 一旦连接成功，你就可以通过LLM与服务器交互了。LLM可以使用服务器提供的工具（例如 'createTask', 'updateTask', 'getAllTasks' 等）来管理你的待办事项。例如，你可以直接指示LLM执行“帮我创建一个新的待办事项，内容是‘阅读MCP文档’，优先级高”。

服务器会负责处理这些请求，将待办事项保存在 '~/.claude/todos/' 目录下的JSON文件中。

信息

分类

生产力应用

访问项目