To Do Manager MCP Server

待办事项管理器MCP服务器

通过模型上下文协议（MCP）管理待办事项的服务器。专为与AI助手和MCP兼容客户端集成而设计。使用Redis提供持久、自动到期的待办事项存储，并可在Vercel上部署。

______________________________________________________________________

项目描述

该项目实现了一个具有添加、列表、更新和删除操作的待办事项管理器API。它旨在与MCP客户端和AI工具一起使用，适合作为基于MCP的集成的参考或起点。

______________________________________________________________________

特性

• 添加、列出、更新和删除待办事项
• 自动过期：待办事项将在3小时后删除
• 使用Redis的持久存储
• MCP协议支持人工智能和自动化工作流程
• 可在Vercel上部署

______________________________________________________________________

______________________________________________________________________

克劳德桌面AI集成

要将此待办事项管理器MCP服务器与Claude Desktop AI一起使用，请将以下块添加到您的 mcp.json 配置文件：

{
  "mcpServers": {
    "to-do-manager": {
      "url": "https://to-do-manager-mcp-server.vercel.app/mcp"
    }
  }
}

这将使Claude Desktop AI能够直接与您的待办事项管理器服务器进行交互。

安装

1. 克隆存储库：

   git clone https://github.com/V1997/To-Do-Manager-MCP-Server.git
   cd To-Do-Manager-MCP-Server

1. 安装依赖项：

   npm install

1. 配置Redis：

- 使用托管Redis服务（Uptash、Redis Cloud或Vercel Redis集成）。 - 将Redis连接字符串添加到 .env.local:

     REDIS_URL=your_redis_connection_url

1. 启动开发服务器：

   npm run dev

服务器将在以下时间可用 http://localhost:3000

______________________________________________________________________

部署和技术细节

Vercel部署

• 将您的GitHub存储库连接到Vercel。
• 设置 REDIS_URL Vercel项目设置中的环境变量。
• Vercel将在每次向主分支推送时进行构建和部署。
• 该应用程序将在Vercel提供的URL上提供。

Redis使用情况

• 每个待办事项都存储为Redis哈希(todo:{id})带字段： id, text, completed, createdAt.
• Redis列表(todos)保持待办事项ID的顺序。
• 所有Redis操作都是按请求执行的；Redis客户端在每个处理程序中创建并关闭，以实现无服务器兼容性。

自动过期

• 创建待办事项时，使用Redis设置3小时的TTL EXPIRE.
• 3小时后，Redis会自动删除待办事项哈希。
• 在列表/更新中，过期的ID将从 todos 列表。

______________________________________________________________________

在线聊天示例

添加待办事项

User: Remind me to buy groceries later today.
Assistant: Added "buy groceries" to your to-do list.

待办事项列表

User: What do I need to get done?
Assistant:
Here are your current to-dos:
• Buy groceries [ ]

将待办事项标记为已完成

User: I finished buying groceries. Mark that as done.
Assistant: Marked "buy groceries" as completed.

删除待办事项

User: Remove "buy groceries" from my list.
Assistant: Deleted "buy groceries" from your to-dos.

删除所有待办事项

User: Clear my entire to-do list.
Assistant: All to-dos have been deleted.

______________________________________________________________________

用法

通过任何兼容MCP的客户端或HTTP请求与待办事项管理器交互。

添加待办事项

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "add", "text": "Buy groceries"}}}'

待办事项列表

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "list"}}}'

更新待办事项

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "update", "todoId": "YOUR_TODO_ID", "completed": true}}}'

删除所有待办事项

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "delete"}}}'

______________________________________________________________________

使用的技术

• TypeScript
• Next.js
• 雷迪斯
• @vercel/mcp适配器
• 萨德
• 维塞尔

______________________________________________________________________

贡献

1. 分叉存储库
2. 创建新分支(git checkout -b feature/your-feature)
3. 进行更改并提交
4. 推到叉子上，打开Pull Request

______________________________________________________________________

联系

• GitHub问题： 打开一个问题
• 电子邮件：patelvasu1997@gmail.com
• 维护人员：Vasu Patel

这个项目是开源的——将其用作参考或您自己的MCP开发的起点。