Todo List MCP Server

待办事项列表 MCP 服务器

模型上下文协议 (MCP) 服务器提供用于管理待办事项的综合 API。

📚 学习资源:本项目旨在作为 MCP 实现的教学示例。请参阅GUIDE.md ,详细了解该项目的工作原理以及其实现方式。

特征

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

工具

该 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 :生成所有活动(未完成)待办事项的摘要

安装

# Clone the repository git clone https://github.com/RegiByte/todo-list-mcp.git cd todo-list-mcp # Install dependencies npm install # Build the project npm run build

用法

启动服务器

npm start

使用 Claude for Desktop 进行配置

克劳德桌面

将其添加到您的claude_desktop_config.json中:

{ "mcpServers": { "todo": { "command": "node", "args": ["/absolute/path/to/todo-list-mcp/dist/index.js"] } } }
光标
  • 前往“光标设置”-> MCP
  • 添加具有“命令”类型的新 MCP 服务器
  • 添加服务器的绝对路径,用node运行
  • 例如:node /absolute/path/to/todo-list-mcp/dist/index.js

示例命令

与 Claude for Desktop 或 Cursor 一起使用时,您可以尝试:

  • “创建一个待办事项来学习 MCP,并附上描述,解释 MCP 为何有用”
  • “列出我所有活动的待办事项”
  • “用 Markdown 格式创建明天会议的待办事项,并详细说明会议议程”
  • “将我的学习 MCP 待办事项标记为已完成”
  • “总结我所有活动的待办事项”

项目结构

该项目遵循明确的关注点分离,以使代码易于理解:

src/ ├── models/ # Data structures and validation schemas ├── services/ # Business logic and database operations ├── utils/ # Helper functions and formatters ├── config.ts # Configuration settings ├── client.ts # Test client for local testing └── index.ts # Main entry point with MCP tool definitions

从这个项目中学习

本项目旨在提供教育资源。如何充分利用它:

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

发展

建筑

npm run build

以开发模式运行

npm run dev

执照

麻省理工学院

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

模型上下文协议 (MCP) 服务器提供管理待办事项的工具,包括创建、更新、完成、删除、搜索和汇总任务。

  1. Features
    1. Tools
      1. Installation
        1. Usage
          1. Starting the Server
          2. Configuring with Claude for Desktop
          3. Example Commands
        2. Project Structure
          1. Learning from This Project
            1. Development
              1. Building
              2. Running in Development Mode
            2. License

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.
                Last updated -
                117
                Python
                MIT License
              • A
                security
                A
                license
                A
                quality
                A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
                Last updated -
                3
                9
                36
                JavaScript
                Apache 2.0
              • -
                security
                A
                license
                -
                quality
                MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
                Last updated -
                4
                3
                TypeScript
                MIT License
              • -
                security
                A
                license
                -
                quality
                MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
                Last updated -
                13
                2
                TypeScript
                MIT License

              View all related MCP servers

              ID: kh39rjpplx