待办事项列表-MCP

Name: 待办事项列表-MCP
Author: RegiByte

作者：RegiByte37 星标更新：2025-03-13

安装使用来源：spider==github.com

项目介绍

Todo List MCP Server

这是一个提供全面API来管理待办事项的模型上下文协议（MCP）服务器。

📚 学习资源：此项目作为MCP实现的教学示例设计。参见GUIDE.md以获得关于项目工作原理及其实施方式的详细解释。

特性

创建待办事项：添加具有标题和Markdown描述的新任务
更新待办事项：修改现有任务
完成待办事项：标记任务已完成
删除待办事项：从列表中移除任务
搜索待办事项：通过标题或创建日期查找任务
总结待办事项：获取活动任务的快速概览

工具

此MCP服务器公开以下工具：

create-todo：创建一个新的待办事项
list-todos：列出所有待办事项
get-todo：通过ID获取特定的待办事项
update-todo：更新待办事项的标题或描述
complete-todo：标记待办事项为已完成
delete-todo：删除待办事项
search-todos-by-title：按标题搜索待办事项（不区分大小写的部分匹配）
search-todos-by-date：按创建日期搜索待办事项（格式：YYYY-MM-DD）
list-active-todos：列出所有未完成的待办事项
summarize-active-todos：生成所有活动（未完成）待办事项的摘要

安装

# 克隆仓库
git clone https://github.com/RegiByte/todo-list-mcp.git
cd todo-list-mcp

# 安装依赖
npm install

# 构建项目
npm run build

使用方法

启动服务器

npm start

配置用于桌面版Claude

Claude Desktop

在你的claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/绝对路径/to/todo-list-mcp/dist/index.js"]
    }
  }
}

Cursor

前往“Cursor 设置” -> MCP
添加一个新MCP服务器，类型为“命令”
添加服务器的绝对路径并使用node运行它
示例：node /绝对路径/to/todo-list-mcp/dist/index.js

示例命令

当与桌面版Claude或Cursor一起使用时，你可以尝试：

“创建一个学习MCP的待办事项，并附带说明为什么MCP有用的描述”
“列出我所有的活动待办事项”
“为明天的会议创建一个待办事项，并用Markdown详细说明议程”
“标记我的学习MCP待办事项为已完成”
“总结我所有的活动待办事项”

项目结构

该项目遵循清晰的关注点分离原则，使代码易于理解：

src/
├── models/       # 数据结构和验证模式
├── services/     # 业务逻辑和数据库操作
├── utils/        # 辅助函数和格式化程序
├── config.ts     # 配置设置
├── client.ts     # 本地测试用的测试客户端
└── index.ts      # 主入口点，包含MCP工具定义

从本项目学习

此项目作为教育资源设计。为了充分利用它：

阅读GUIDE.md，了解设计的全面解释
研究注释丰富的源代码，以理解实现细节
使用测试客户端查看服务器的实际工作情况
尝试添加自己的工具或扩展现有的工具

开发

构建

npm run build

在开发模式下运行

npm run dev

许可证

MIT