MCP Wait Timer Server
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 블록을 추가하세요. 클라이언트와 운영 체제에 맞는 파일을 선택하세요.
구성 블록:
"wait-timer": {
"command": "npx",
"args": ["mcp-wait-timer"],
"env": {},
"disabled": false,
"autoApprove": []
}클라이언트 구성 파일 위치:
클로드 데스크탑:
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 클라이언트에 다음을 지시할 수 있습니다.
"Please wait for 10 seconds before proceeding."클라이언트의 AI 모델은 의도를 인식하고 duration_seconds: 10 으로 wait 도구를 호출해야 합니다.
개발자
이 도구는 인간의 건강과 장수의 경계를 확장하는 데 초점을 맞춘 그룹인 199 Longevity 의 이니셔티브의 일환으로 개발되었습니다.
199.bio 에서 생명공학 분야에서의 당사의 활동에 대해 자세히 알아보세요.
프로젝트 참여자: Boris Djordjevic
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
Available Tools
1 toolwaitA
Waits for a specified duration in seconds.
| Name | Required | Description | Default |
|---|---|---|---|
| duration_seconds | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the action ('waits') but does not explain how the wait is implemented (e.g., blocking vs. non-blocking), potential side effects, or error handling. This leaves gaps in understanding the tool's behavior beyond the basic action.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence that efficiently conveys the tool's function without unnecessary details. It is front-loaded and wastes no words, making it easy to understand at a glance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (one parameter, no output schema, no annotations), the description is minimally adequate but lacks depth. It covers the basic action but does not address behavioral aspects like implementation details or error scenarios, which could be important for a wait function in some contexts.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds meaning by specifying that the parameter is for 'duration in seconds,' which clarifies the unit and purpose beyond the schema's description ('The number of seconds to wait'). With 0% schema description coverage, the description compensates well by providing essential context, though it could note the minimum value constraint from the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('waits') and resource ('duration in seconds'), making it immediately understandable. It distinguishes itself by focusing solely on time-based waiting functionality, which is straightforward given there are no sibling tools to differentiate from.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for delaying execution by a specified time, but provides no explicit guidance on when to use this tool versus alternatives or any prerequisites. With no sibling tools, the context is limited, but it lacks details on scenarios where waiting is appropriate or any constraints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.0.0- First observed
wait
TDQS
Scored across 1 tool
With only one tool, there is no possibility for ambiguity or overlap between tools. The tool 'wait' has a single, clear purpose that cannot be confused with any other tool in this set.
The naming is trivially consistent as there is only one tool. The tool name 'wait' follows a simple verb pattern, and there are no other tools to create inconsistency or mixed conventions.
A single tool is too few for most server purposes, making the server feel thin and limited in scope. While a timer server might logically have few tools, one tool is borderline minimal and may not cover all expected timer-related operations, such as cancelling or listing waits.
The tool set is severely incomplete for a timer server. It only provides a wait function, missing obvious operations like cancelling an active wait, checking wait status, or managing multiple timers, which are common in timer-related domains.
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Concierge MCP for agentic workflows: verified time + drift, uuid, diff, calc, attest, verify.
Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that provides a simple sleep/wait tool, useful for adding delays between operations such as waiting between API calls or testing eventually consistent systems.16 npm23ISC
- AlicenseBqualityDmaintenanceTool that allows you to wait a certain time to continue the execution of an agent.11Apache 2.0
- AlicenseBqualityDmaintenanceA simple MCP server that provides waiting functionality to pause until other tasks finish, with progress reporting and support for CLI or HTTP server with SSE.123 npm5MIT
- AlicenseNot gradedqualityDmaintenanceProvides a wait tool for AI agents to pause execution until a time duration elapses or a process terminates, useful for polling and waiting for builds/deployments.10 npmMIT