Todo List MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供用于管理待办事项的全面 API。

<a href="https://glama.ai/mcp/servers/kh39rjpplx"> <img width="380" height="200" src="https://glama.ai/mcp/servers/kh39rjpplx/badge" alt="Todo List Server MCP server" /> </a>

📚 学习资源: 此项目旨在作为 MCP 实现的教育示例。请参阅 GUIDE.md，以获得关于项目如何工作以及为什么以这种方式实现的全面解释。

功能

• 创建待办事项: 添加带有标题和 Markdown 描述的新任务
• 更新待办事项: 修改现有任务
• 完成待办事项: 将任务标记为已完成
• 删除待办事项: 从列表中移除任务
• 搜索待办事项: 按标题或创建日期查找任务
• 总结待办事项: 快速了解活动任务

工具

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

1. create-todo: 创建新的待办事项
2. list-todos: 列出所有待办事项
3. get-todo: 按 ID 获取特定待办事项
4. update-todo: 更新待办事项的标题或描述
5. complete-todo: 将待办事项标记为已完成
6. delete-todo: 删除待办事项
7. search-todos-by-title: 按标题搜索待办事项（不区分大小写的部分匹配）
8. search-todos-by-date: 按创建日期搜索待办事项（格式：YYYY-MM-DD）
9. list-active-todos: 列出所有未完成的待办事项
10. 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 for Desktop 进行配置

Claude Desktop

将此添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/absolute/path/to/todo-list-mcp/dist/index.js"]
    }
  }
}

Cursor

• 转到 "Cursor Settings" -> MCP
• 添加一个新的 MCP 服务器，类型为 "command"
• 添加服务器的绝对路径并使用 node 运行它
• 示例: node /absolute/path/to/todo-list-mcp/dist/index.js

示例命令

当与 Claude for Desktop 或 Cursor 一起使用时，您可以尝试：

• "Create a todo to learn MCP with a description explaining why MCP is useful" (创建一个学习 MCP 的待办事项，并附上描述解释为什么 MCP 有用)
• "List all my active todos" (列出我所有活动的待办事项)
• "Create a todo for tomorrow's meeting with details about the agenda in markdown" (为明天的会议创建一个待办事项，并在 Markdown 中包含议程的详细信息)
• "Mark my learning MCP todo as completed" (将我学习 MCP 的待办事项标记为已完成)
• "Summarize all my active todos" (总结我所有活动的待办事项)

项目结构

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

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

从本项目学习

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

1. 阅读 GUIDE.md 以获得关于设计的全面解释
2. 研究带有大量注释的源代码以了解实现细节
3. 使用测试客户端查看服务器在实践中如何工作
4. 尝试添加您自己的工具或扩展现有工具

开发

构建

npm run build

在开发模式下运行

npm run dev

许可证

MIT