MCP 대기 타이머 서버
간단한 wait 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.
데모 영상을 시청하세요: https://www.youtube.com/watch?v=TaF_j9wrWVw
개요
이 서버는 MCP 클라이언트(예: Cline, Claude Desktop, Cursor)가 실행하는 워크플로에 의도적인 일시 중지를 도입하도록 설계된 wait 이라는 단일 도구를 제공합니다.
Related MCP server: mcp-sleep
문제 해결
MCP 클라이언트와 이를 구동하는 AI 모델은 종종 순차적으로 작동합니다. 명령이나 작업(웹 요청, 파일 작업 또는 API 호출 등)을 실행한 후 모델은 즉시 다음 단계로 넘어갈 수 있습니다. 그러나 일부 작업은 효과를 완전히 완료하는 데 추가 시간이 필요합니다(예: 백그라운드 프로세스 완료, JavaScript 실행 후 웹 페이지 완전히 렌더링, 파일 시스템 전파).
이 모델은 이러한 비동기 효과가 완료되는 시점을 항상 안정적으로 감지할 수 없으므로 조기에 진행되어 후속 단계에서 오류나 잘못된 가정이 발생할 수 있습니다.
해결책: wait 도구
이 서버는 사용자 또는 AI 프롬프트가 클라이언트에게 특정 시간 동안 일시 중지한 후 작업을 계속 진행하도록 명시적으로 지시할 수 있는 wait 도구를 제공합니다. 이를 통해 시간 의존적인 작업이 완료될 충분한 시간을 확보할 수 있습니다.
도구: wait
설명: 지정된 초 동안 실행을 일시 중지합니다.
입력 매개변수:
duration_seconds(숫자, 필수): 대기 시간(초)입니다. 양수여야 합니다.
사용 사례
웹 자동화: 페이지 탐색이나 요소 상호 작용 후 동적 콘텐츠 로드 또는 스크립트 실행이 완료되도록 보장합니다.
지엑스피1
명령줄 작업: 셸 명령으로 시작된 백그라운드 작업, 파일 쓰기 또는 서비스 시작을 위한 시간을 허용합니다.
Example Prompt: "Run 'npm run build', wait for 15 seconds, then check if the 'dist/app.js' file exists."API 상호작용: 속도 제한을 처리하거나 비동기 작업 완료를 기다리기 위해 API 호출 사이에 지연 시간을 추가합니다.
워크플로 디버깅: 복잡한 작업 중 특정 지점에서 시스템 상태를 관찰하기 위해 일시 중지를 삽입합니다.
설치 및 설정
이 서버에는 Node.js(버전 16 이상)가 필요합니다.
1단계: MCP 클라이언트 구성
클라이언트 구성 파일의 "mcpServers": {} 객체 내에 다음 JSON 블록을 추가하세요. 클라이언트와 운영 체제에 맞는 파일을 선택하세요.
구성 블록:
클라이언트 구성 파일 위치:
클로드 데스크탑:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json(경로는 약간 다를 수 있음)
VS 코드 확장 프로그램(클라인/"클로드 코드"):
macOS:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonWindows:
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json리눅스:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
커서:
글로벌:
~/.cursor/mcp.json프로젝트별: 프로젝트 폴더 내에
.cursor/mcp.json파일을 만듭니다.
윈드서핑:
~/.codeium/windsurf/mcp_config.json
다른 고객:
MCP 구성 파일의 위치는 해당 클라이언트의 설명서를 참조하십시오. 위의 "구성 블록"에 표시된 JSON 구조가 일반적으로 작동합니다.
2단계: 클라이언트 다시 시작
구성 블록을 추가하고 파일을 저장한 후, 변경 사항을 적용하려면 MCP 클라이언트 애플리케이션을 완전히 다시 시작하세요 . 클라이언트가 서버를 처음 시작할 때 npx mcp-wait-timer 패키지가 아직 캐시되지 않은 경우 자동으로 다운로드합니다.
사용 예
설치하고 활성화하면 MCP 클라이언트에 다음을 지시할 수 있습니다.
클라이언트의 AI 모델은 의도를 인식하고 duration_seconds: 10 으로 wait 도구를 호출해야 합니다.
개발자
이 도구는 인간의 건강과 장수의 경계를 확장하는 데 초점을 맞춘 그룹인 199 Longevity 의 이니셔티브의 일환으로 개발되었습니다.
199.bio 에서 생명공학 분야에서의 당사의 활동에 대해 자세히 알아보세요.
프로젝트 참여자: Boris Djordjevic
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.