Sleep MCP 서버

이 MCP 서버는 에이전트 흐름을 제어하기 위해 지정된 시간 동안 실행을 일시 중지합니다. 시간 지연을 도입하여 작업이 원하는 순서대로 실행되도록 자동화를 강화하세요. 작업 간 대기 시간이 필요한 워크플로 관리에 이상적입니다.

설정

설치

MCP 패키지 관리자 사용

대장간

Smithery를 통해 Claude Desktop용 Sleep MCP를 자동으로 설치하려면:

지엑스피1

mcp-get

mcp-get을 사용하여 Sleep MCP 서버를 설치할 수 있습니다.

npx @michaellatman/mcp-get@latest install mcp-sleep

필수 조건

MCP는 아직 매우 새롭고 계속 발전하고 있으므로 MCP 기본 사항을 익히고 실행하려면 MCP 설명서를 따르는 것이 좋습니다.

필요한 것:

구성

1. Claude Desktop 구성

OS에 따라 다음 파일을 만듭니다.

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

이 템플릿을 파일에 붙여넣으세요

{
    "mcpServers": {
        "mcp-sleep": {
            "command": "uvx",
            "args": [
                "mcp-sleep"
            ],
        }
    }
}

선택적으로 <MCP_SLEEP_TIMEOUT> 원하는 시간 제한(대기할 수 있는 최대 시간, 기본값 60초)으로 바꾸세요.

{
    "mcpServers": {
        "mcp-sleep": {
            "command": "uvx",
            "args": [
                "mcp-sleep"
            ],
            "env": {
                "MCP_SLEEP_TIMEOUT": "<MCP_SLEEP_TIMEOUT>"
            }
        }
    }
}

2. Claude Desktop을 다시 시작하세요

SSE 모드

또는 다음 명령을 실행하여 SSE 모드에서 MCP 서버를 실행할 수 있습니다.

uvx mcp-sleep --transport sse

이 모드는 SSE를 지원하는 MCP 클라이언트(웹 앱 등)와 통합하는 데 유용합니다.

도구

sleep
- 에이전트의 흐름을 제어하기 위해 지정된 기간 동안 실행을 일시 중지합니다.
- 입력:
  - seconds (숫자, 최대 시간 초과 구성 값): 계속 진행하라는 메시지를 표시하는 데 걸리는 시간(초)
- 반환: {seconds} 후에 "{seconds}초 동안 기다린 후 작업을 계속할 수 있습니다."라는 문장이 표시됩니다. 최대 대기 시간보다 큰 대기 시간을 입력하면 "구성상 {ctx.sleep.config.timeout}초 이상 대기할 수 없습니다."라는 결과가 표시됩니다.

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 claude_desktop_config.json 에 다음을 추가하세요.

도커

{
  "mcpServers": {
    "mcp-sleep": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SLEEP_TIMEOUT",
        "mcp/sleep"
      ],
      "env": {
        "MCP_SLEEP_TIMEOUT": "<MCP_SLEEP_TIMEOUT>"
      }
    }
  }
}

개발

구성

로컬로 작업하는 경우 저장소 루트에 있는 .env 파일에 두 개의 환경 변수를 추가합니다.

MCP_SLEEP_TIMEOUT=

로컬 개발을 위해 Claude Desktop 구성을 업데이트하세요.

{
  "mcpServers": {
      "mcp-sleep_local": {
          "command": "uv",
          "args": [
              "run",
              "--directory",
              "/path/to/your/mcp-sleep",
              "run",
              "mcp-sleep"
          ]
      }
  }
}

"mcpServers": {
  "mcp-sleep": {
    "command": "uvx",
    "args": [
      "mcp-sleep"
    ]
  }
}

건축 및 출판

배포를 위해 패키지를 준비하려면:

종속성 동기화 및 잠금 파일 업데이트:

uv sync

패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

토큰: --token 또는 UV_PUBLISH_TOKEN
또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

Docker 빌드:

docker build -t mcp/sleep -f Dockerfile .

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-sleep run mcp-sleep

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

mcp-sleep

Integrations