MCP 서버 Todo 목록

할 일 항목을 관리하기 위한 포괄적인 API를 제공하는 MCP(Model Context Protocol) 서버입니다.

📚 학습 자료 : 이 프로젝트는 MCP 구현의 교육적 예시로 설계되었습니다. 프로젝트 작동 방식과 구현 방식에 대한 자세한 설명은 GUIDE.md를 참조하세요.

특징

• 할 일 만들기 : 제목과 마크다운 설명이 있는 새 작업 추가
• 할 일 업데이트 : 기존 작업 수정
• 완료할 일 : 작업을 완료로 표시
• 할 일 삭제 : 목록에서 작업 제거
• 할 일 검색 : 제목이나 생성 날짜로 작업 찾기
• 할 일 요약 : 활성 작업에 대한 빠른 개요를 얻으세요

도구

이 MCP 서버는 다음 도구를 제공합니다.

1. create-todo : 새로운 할 일 항목을 생성합니다.
2. list-todos : 모든 할 일 목록
3. get-todo : ID로 특정 todo 가져오기
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 : 완료되지 않은 모든 todos를 나열합니다.
10. summarize-active-todos : 모든 활성(완료되지 않은) todos에 대한 요약을 생성합니다.

설치

지엑스피1

용법

서버 시작

Claude를 사용하여 데스크톱 구성

클로드 데스크탑

claude_desktop_config.json 에 다음을 추가하세요:

커서

• "커서 설정" -> MCP로 이동하세요.
• "명령" 유형으로 새 MCP 서버 추가
• 서버의 절대 경로를 추가하고 node로 실행하세요.
• 예: node /absolute/path/to/todo-list-mcp/dist/index.js

예제 명령

Claude for Desktop 또는 Cursor와 함께 사용할 경우 다음을 시도해 보세요.

• "MCP가 유용한 이유를 설명하는 설명과 함께 MCP를 배우기 위한 할 일을 만드세요."
• "내 모든 활성 작업 나열"
• "마크다운으로 안건에 대한 세부 정보를 포함하여 내일 회의의 할 일을 작성하세요"
• "내 MCP 학습 할 일을 완료로 표시"
• "내 모든 활성 작업 요약"

프로젝트 구조

이 프로젝트에서는 코드를 이해하기 쉽게 만들기 위해 관심사를 명확하게 분리했습니다.

이 프로젝트에서 얻은 교훈

이 프로젝트는 교육 자료로 설계되었습니다. 최대한 활용하려면 다음을 수행하세요.

1. 디자인에 대한 포괄적인 설명은 GUIDE.md 를 읽어보세요.
2. 구현 세부 사항을 이해하려면 주석이 많이 달린 소스 코드를 연구하세요.
3. 테스트 클라이언트를 사용하여 서버가 실제로 어떻게 작동하는지 확인하세요.
4. 자신만의 도구를 추가하거나 기존 도구를 확장하여 실험해 보세요.

개발

건물

개발 모드에서 실행

특허

MIT