使用说明

项目简介

本项目实现了基于 Model Context Protocol (MCP) 的一个简单服务器，该服务器提供了一个名为 'wait_seconds' 的工具。当 MCP 客户端调用此工具时，服务器会等待指定的秒数，然后返回一个简单的文本响应。此服务器主要用于演示 MCP 客户端与服务器之间的交互，特别是模拟网络延迟或服务器处理时间。

主要功能点

提供 'wait_seconds' 工具: 允许客户端请求服务器等待一段时间。
TypeScript 和 Python 实现: 提供两种语言的服务器版本，方便不同技术栈的用户使用。
基于 MCP 协议: 遵循 MCP 协议规范，可以与任何兼容 MCP 协议的客户端进行交互。
使用标准输入输出 (stdio) 通信: 服务器和客户端通过标准输入输出流进行通信，简化部署和集成。

安装步骤

对于 Python 版本：

确保已安装 Python 3.7 或更高版本。

克隆仓库到本地：

git clone https://github.com/MCP-Mirror/7shi_mcp-wait.git
cd 7shi_mcp-wait/py

安装 Python 依赖：

pip install -r requirements.txt

对于 TypeScript 版本：

确保已安装 Node.js 和 npm。

克隆仓库到本地：

git clone https://github.com/MCP-Mirror/7shi_mcp-wait.git
cd 7shi_mcp-wait/ts

安装 TypeScript 依赖并编译：

npm install
npm run build

服务器配置

MCP 客户端配置 (JSON 格式):

您需要配置 MCP 客户端以连接到此 MCP 服务器。以下是 Python 和 TypeScript 版本的服务器配置示例，请根据您使用的客户端进行配置，只需填入 'command' 和 'args' 即可，无需修改其他字段。

Python 版本配置：

{
  "serverName": "mcp-wait-py",
  "command": "python",
  "args": ["server.py"],
  "transport": "stdio"
}

'serverName': 服务器名称，用于标识服务器。
'command': 启动服务器的命令，这里是 'python'。
'args': 传递给启动命令的参数，这里是 Python 服务器脚本 'server.py'。
'transport': 指定通信方式为 'stdio' (标准输入输出)。

TypeScript 版本配置：

{
  "serverName": "mcp-wait-ts",
  "command": "node",
  "args": ["dist/index.js"],
  "transport": "stdio"
}

'serverName': 服务器名称，用于标识服务器。
'command': 启动服务器的命令，这里是 'node'。
'args': 传递给启动命令的参数，这里是编译后的 JavaScript 服务器脚本 'dist/index.js'。
'transport': 指定通信方式为 'stdio' (标准输入输出)。

请注意: TypeScript 版本需要先执行 'npm run build' 命令编译 TypeScript 代码才能运行。

基本使用方法

启动 MCP 服务器:
- Python 版本: 在 'py' 目录下运行 'python server.py'。
- TypeScript 版本: 在 'ts' 目录下运行 'npm run start' (或者直接运行 'node dist/index.js')。
配置 MCP 客户端: 根据您使用的 MCP 客户端的文档，配置客户端连接到上面配置的 MCP 服务器。

使用 'wait_seconds' 工具: 在 MCP 客户端中，您可以调用 'wait_seconds' 工具，并传递 'seconds' 参数来指定等待的秒数。例如，发送如下 JSON-RPC 请求 (示例，具体请求格式请参考 MCP 客户端文档):

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "name": "wait_seconds",
    "arguments": {
      "seconds": 3
    }
  },
  "id": 1
}

服务器将等待 3 秒后返回响应。

通过这个简单的 'wait_seconds' 工具，您可以测试 MCP 客户端与服务器的连接和基本的工具调用流程。

关键词