MCP Shrimp Task Manager 사용 및 설치 메뉴얼

소개

MCP Shrimp Task Manager는 Model Context Protocol(MCP)을 기반으로 한 지능형 태스크 관리 시스템으로, 복잡한 프로젝트를 효율적으로 관리할 수 있도록 설계되었습니다. 이 도구는 태스크 계획, 지능형 분해, 의존성 관리, 리서치 모드, 태스크 메모리 기능, 프로젝트 규칙 초기화, 웹 GUI 등 다양한 기능을 제공합니다. 이 메뉴얼은 설치 방법, 사용 방법, 설정 방법, 라이선스 정보, 권장 모델 등을 포함하여 사용자가 MCP Shrimp Task Manager를 쉽게 시작할 수 있도록 안내합니다.

기능

MCP Shrimp Task Manager는 다음과 같은 주요 기능을 제공합니다:

기능 설명

태스크 계획	태스크를 효율적으로 계획하고 조직화합니다.
지능형 분해	복잡한 태스크를 관리 가능한 하위 태스크로 분해합니다.
의존성 관리	태스크 간 의존성을 관리하여 원활한 실행을 보장합니다.
리서치 모드	정보에 기반한 의사 결정을 위해 리서치 기능을 제공합니다.
태스크 메모리 기능	태스크 관련 정보를 저장하고 호출합니다.
프로젝트 규칙 초기화	프로젝트에 대한 규칙과 가이드라인을 설정합니다.
웹 GUI	사용자 친화적인 그래픽 인터페이스를 통해 쉽게 상호작용할 수 있습니다.

설치 방법

MCP Shrimp Task Manager는 두 가지 설치 방법을 제공합니다:

Smithery를 통한 자동 설치:
- Claude Desktop 사용자는 Smithery를 통해 자동으로 설치할 수 있습니다. 이 방법은 간단하며, 추가 설정 없이 빠르게 시작할 수 있습니다.
수동 설치:
- 다음 명령어를 사용하여 설치합니다:
```
npm install
npm run build
```
- npm install은 필요한 의존성을 설치하고, npm run build는 프로젝트를 빌드하여 서비스를 시작합니다.

사용 방법

MCP Shrimp Task Manager는 Cursor IDE와 같은 MCP 클라이언트와 호환되며, 전역 및 프로젝트별 설정을 지원합니다. 아래는 주요 사용 방법과 설정에 대한 상세 정보입니다.

설정

환경 변수:
- DATA_DIR: 데이터 디렉토리의 절대 경로를 지정합니다(예: /path/to/data).
- TEMPLATES_USE: 템플릿 언어를 선택합니다. 기본값은 en(영어)이며, zh(중국어) 또는 사용자 정의 언어를 사용할 수 있습니다.
- ENABLE_GUI: .env 파일에서 true로 설정하면 웹 GUI가 활성화되며, DATA_DIR에 WebGUI.md 파일이 생성됩니다.
프롬프트 커스터마이징:
- 프롬프트를 재정의하려면 MCP_PROMPT_[FUNCTION_NAME]을 사용합니다.
- 기존 프롬프트에 추가하려면 MCP_PROMPT_[FUNCTION_NAME]_APPEND를 사용합니다.
- 자세한 내용은 프롬프트 커스터마이징 가이드를 참조하세요.

모드

MCP Shrimp Task Manager는 두 가지 주요 모드를 제공합니다:

TaskPlanner: plan_task 함수를 사용하여 태스크를 계획합니다. 이 모드는 태스크를 체계적으로 조직화하는 데 유용합니다.
TaskExecutor: execute_task 함수를 사용하여 태스크를 실행하며, 연속 모드를 지원하여 반복적인 작업을 자동화할 수 있습니다.

사용 가능한 도구

설정을 완료하면 다음 도구를 사용할 수 있습니다:

도구 이름 설명

plan_task	태스크를 계획합니다.
analyze_task	태스크를 분석하여 세부 정보를 제공합니다.
process_thought	태스크와 관련된 사고 과정을 처리합니다.
reflect_task	태스크를 검토하고 피드백을 제공합니다.
research_mode	리서치 모드를 활성화하여 데이터를 조사합니다.
init_project_rules	프로젝트 규칙을 초기화합니다.
split_tasks	태스크를 하위 태스크로 분할합니다.
list_tasks	현재 태스크 목록을 표시합니다.
query_task	특정 태스크에 대한 정보를 조회합니다.
get_task_detail	태스크의 세부 정보를 가져옵니다.
delete_task	태스크를 삭제합니다.
execute_task	태스크를 실행합니다.
verify_task	태스크의 완료 여부를 검증합니다.

웹 GUI

웹 GUI를 활성화하려면 .env 파일에서 ENABLE_GUI=true로 설정하세요. 웹 GUI는 기본 포트 3000에서 실행되며, 사용자 친화적인 인터페이스를 통해 태스크를 관리할 수 있습니다.

라이선스

MCP Shrimp Task Manager는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

권장 모델

최적의 성능을 위해 다음 모델을 사용하는 것이 권장됩니다:

모델 설명

Claude 3.7	높은 성능과 정확도를 제공하며, 복잡한 태스크 처리에 적합합니다.
Gemini 2.5	다양한 태스크에 대해 안정적인 성능을 제공합니다.

다른 모델을 사용할 경우, 학습 및 이해 능력의 차이로 인해 성능이 달라질 수 있습니다.