MCP 대기 타이머 서버

간단한 wait 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

데모 영상을 시청하세요: https://www.youtube.com/watch?v=TaF_j9wrWVw

개요

이 서버는 MCP 클라이언트(예: Cline, Claude Desktop, Cursor)가 실행하는 워크플로에 의도적인 일시 중지를 도입하도록 설계된 wait 이라는 단일 도구를 제공합니다.

문제 해결

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.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json(경로는 약간 다를 수 있음)
• VS 코드 확장 프로그램(클라인/"클로드 코드"):
  • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows: %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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.