MCP TODO 체크리스트

Claude Desktop에서 작업 관리를 위한 체크리스트 시스템을 구축하는 MCP 서버입니다. 이 시스템을 사용하면 우선순위, 마감일, 태그 지원으로 여러 작업 목록을 만들고 관리할 수 있습니다.

특징

✅ 여러 개의 할 일 목록 만들기 및 관리
📌 우선 지원 (낮음, 중간, 높음)
📅 작업 마감일
🏷️ 조직을 위한 태그 시스템
👥 사용자 간 목록 공유
💾 영구 파일 시스템 저장소

요구 사항

Node.js 18 이상
NPM 8 이상

설치

방법 1: 로컬 설치(개발)

저장소를 복제합니다

지엑스피1

종속성을 설치하고 컴파일합니다.

npm install
npm run build

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: 글로벌 설치(사용)

패키지를 전역적으로 설치합니다.

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

claude_desktop_config.json 에서 구성:

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "mcp-server-todo-checklist",
      "config": {
        "storagePath": "C:\\Users\\SEU_USUARIO\\AppData\\Local\\claude-todo-checklist",
        "commandTimeout": 60000
      }
    }
  }
}

Claude에서 사용 가능한 명령

새 목록을 만듭니다

/todo_create {
  "title": "Minha Lista",
  "description": "Descrição opcional da lista"
}

작업 추가

/todo_add {
  "listTitle": "Minha Lista",
  "taskTitle": "Nova Tarefa",
  "priority": "high",
  "dueDate": "2024-01-20",
  "tags": ["trabalho", "urgente"]
}

모든 목록을 나열합니다

/todo_list

목록의 세부 정보 보기

/todo_show {
  "listTitle": "Minha Lista"
}

작업을 완료로 표시

/todo_complete {
  "listTitle": "Minha Lista",
  "taskTitle": "Nova Tarefa"
}

프로젝트 구조

src/
├── index.ts           # Ponto de entrada do servidor
├── commands.ts        # Definição dos comandos disponíveis
├── service/          
│   └── ChecklistService.ts  # Lógica de negócio
├── storage/
│   └── index.ts      # Implementação do armazenamento
└── types/
    ├── ChecklistItem.ts     # Tipos para itens
    └── index.ts            # Tipos principais

데이터 구조

체크리스트

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

작업(체크리스트 항목)

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

개발 스크립트

# Compilar o projeto
npm run build

# Executar em modo desenvolvimento
npm run dev

# Observar alterações e recompilar
npm run watch

# Iniciar o servidor compilado
npm start

설정

claude_desktop_config.json 파일에서 다음을 구성할 수 있습니다.

storagePath : 데이터가 저장될 디렉토리
commandTimeout : 최대 명령 실행 시간(밀리초) (기본값: 60000)

사용된 기술

타입스크립트
모델 컨텍스트 프로토콜 SDK
Zod(데이터 검증)
파일 기반 저장 시스템

특허

MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 참조하세요.

MCP TODO Checklist Server