MCP TODO 清单

一个 MCP 服务器，实现了用于在 Claude Desktop 中管理任务的清单系统。该系统允许创建和管理多个任务列表，支持优先级、截止日期和标签。

功能

• ✅ 创建和管理多个任务列表
• 📌 支持优先级（低、中、高）
• 📅 任务截止日期
• 🏷️ 用于组织的标签系统
• 👥 用户之间共享列表
• 💾 持久化存储在文件系统中

要求

• Node.js 18 或更高版本
• NPM 8 或更高版本

安装

方法 1：本地安装（开发）

1. 克隆存储库

cd C:\workspace\mcp
git clone (你的存储库) mcp-mr-checklist
cd mcp-mr-checklist

2. 安装依赖并编译

npm install
npm run build

3. 在 claude_desktop_config.json 中配置：

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "node dist/index.js",
      "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
      "config": {
        "storagePath": "./data",
        "commandTimeout": 60000
      }
    }
  }
}

方法 2：全局安装（使用）

1. 全局安装包

npm install -g @hevener/server-todo-checklist

2. 在 claude_desktop_config.json 中配置：

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "mcp-server-todo-checklist",
      "config": {
        "storagePath": "C:\\Users\\你的用户名\\AppData\\Local\\claude-todo-checklist",
        "commandTimeout": 60000
      }
    }
  }
}

Claude 中可用的命令

创建一个新列表

/todo_create {
  "title": "我的列表",
  "description": "列表的可选描述"
}

添加一个任务

/todo_add {
  "listTitle": "我的列表",
  "taskTitle": "新任务",
  "priority": "high",
  "dueDate": "2024-01-20",
  "tags": ["工作", "紧急"]
}

列出所有列表

/todo_list

查看列表的详细信息

/todo_show {
  "listTitle": "我的列表"
}

将任务标记为已完成

/todo_complete {
  "listTitle": "我的列表",
  "taskTitle": "新任务"
}

项目结构

src/
├── index.ts           # 服务器的入口点
├── commands.ts        # 可用命令的定义
├── service/          
│   └── ChecklistService.ts  # 业务逻辑
├── storage/
│   └── index.ts      # 存储的实现
└── types/
    ├── ChecklistItem.ts     # 项目的类型
    └── index.ts            # 主要类型

数据结构

列表 (Checklist)

interface Checklist {
  id: string;
  title: string;
  description?: string;
  items: ChecklistItem[];
  owner: string;
  shared?: string[];
  createdAt: Date;
  updatedAt: Date;
}

任务 (ChecklistItem)

interface ChecklistItem {
  id: string;
  title: string;
  description?: string;
  completed: boolean;
  dueDate?: Date;
  priority: 'low' | 'medium' | 'high';
  tags: string[];
  createdAt: Date;
  updatedAt: Date;
}

开发脚本

# 编译项目
npm run build

# 在开发模式下运行
npm run dev

# 观察更改并重新编译
npm run watch

# 启动编译后的服务器
npm start

配置

在 claude_desktop_config.json 文件中，您可以配置：

• storagePath: 数据存储的目录
• commandTimeout: 命令的最大执行时间，以毫秒为单位（默认值：60000）

使用的技术

• TypeScript
• Model Context Protocol SDK
• Zod (数据验证)
• 基于文件的存储系统

许可证

根据 MIT 许可证分发。 有关更多信息，请参见 LICENSE。