Sleep MCP Server 使用说明

项目简介

Sleep MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,专注于提供一个实用的 sleep 工具。该工具允许用户在需要时引入指定毫秒数的延迟,这在 LLM 应用的工作流编排中非常有用,例如:

  • 在连续的 API 调用之间增加等待时间,避免请求频率过快。
  • 在测试最终一致性的系统时,等待数据同步完成。
  • 在需要人为暂停的场景中,例如等待用户操作。

主要功能点

  • 提供 sleep 工具: 允许 LLM 客户端调用 'sleep' 工具,指定等待的毫秒数,服务器将暂停执行指定时间后返回。
  • MCP 协议支持: 遵循 MCP 协议标准,可以与任何兼容 MCP 协议的 LLM 客户端(如 Cline)进行交互。
  • 标准 Stdio 传输: 使用标准输入输出 (stdio) 作为传输协议,易于集成和部署。

安装步骤

  1. 克隆仓库
    git clone https://github.com/Garoth/sleep-mcp.git
    cd sleep-mcp
  2. 安装依赖 确保你已经安装了 Node.js 和 npm。在项目根目录下运行:
    npm install
  3. 构建项目
    npm run build
    构建完成后,'index.js' 文件将位于 'build' 目录下。

服务器配置

要将 Sleep MCP Server 集成到 MCP 客户端(例如 Cline),你需要配置客户端的 MCP 服务器设置。以 Cline 为例,在 'cline_mcp_settings.json' 文件中添加如下配置:

{
  "mcpServers": {
    "sleep": {
      "command": "node",
      "args": ["/path/to/sleep-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": [],
      "timeout": 300
    }
  }
}

配置参数说明:

  • server name (sleep): 为该 MCP 服务器指定一个名称,例如 "sleep",客户端将使用此名称来标识和调用该服务器。
  • command (node): 运行 MCP 服务器的命令,这里使用 'node' 来执行 JavaScript 代码。
  • args (["/path/to/sleep-mcp/build/index.js"]): 传递给 'command' 的参数,指定了 Sleep MCP Server 的入口文件路径。请将 '/path/to/sleep-mcp' 替换为 Sleep MCP Server 仓库在你的本地文件系统中的实际路径。
  • disabled (false): 设置为 'false' 表示启用该 MCP 服务器。
  • autoApprove ([]): 自动批准的工具列表,这里为空表示不自动批准任何工具调用。
  • timeout (300): MCP 客户端等待服务器响应的超时时间,单位为毫秒。请确保此超时时间大于你可能使用的最大 sleep 时长,避免因超时导致 'sleep' 工具调用失败。

基本使用方法

配置完成后,MCP 客户端将能够发现并调用 Sleep MCP Server 提供的 'sleep' 工具。

例如,在 Cline 中,你可以通过自然语言指令或编程方式调用 'sleep' 工具,并指定等待的毫秒数。客户端会将请求发送到 Sleep MCP Server,服务器执行等待操作后,将返回操作结果。

工具调用示例 (假设使用 Cline):

请等待 5 秒钟

或在代码中:

response = client.call_tool("sleep", {"milliseconds": 5000})
print(response) # 输出类似: {'content': [{'type': 'text', 'text': 'Waited for 5000 milliseconds'}]}

具体工具调用方式取决于你使用的 MCP 客户端的接口和指令格式。请参考你所使用的 MCP 客户端的文档。

信息

分类

开发者工具