关键词

时间工具时区工具服务自动化实用工具

使用说明

项目简介

Time MCP Server 示例是一个基于 Model Context Protocol (MCP) 构建的简单服务器，它演示了如何使用 MCP 协议提供工具服务。该服务器提供两个工具：'get-current-time' 用于获取当前时间，'get-time-in-timezone' 用于获取指定时区的时间。

主要功能点

  • 提供时间工具： 通过 MCP 协议向客户端提供 'get-current-time' 和 'get-time-in-timezone' 两个工具，允许客户端获取当前时间或指定时区的时间。
  • 基于 MCP 协议： 完全遵循 Model Context Protocol (MCP) 协议规范，使用 JSON-RPC 进行通信，并支持 Stdio 传输协议。
  • 工具能力声明： 服务器声明了自身提供的工具能力，客户端可以通过 'ListTools' 请求获取工具列表和详细信息。
  • 工具执行： 服务器接收客户端的 'CallTool' 请求，并根据请求参数执行相应的工具，返回 JSON-RPC 响应。

安装步骤

该 MCP 服务器示例是使用 Node.js 开发的，需要先安装 Node.js 环境。

  1. 进入 'mcp-time-js' 目录：

    cd mcp_servers/mcp-time-js

  2. 安装依赖：

    npm install

  3. 构建项目：

    npm run build

    构建完成后，可执行文件 'index.js' 将位于 'build' 目录。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令及其参数才能连接。对于 Time MCP Server 示例，配置信息如下：

{
  "serverName": "time-server",
  "command": "./mcp_servers/mcp-time-js/build/index.js",
  "args": [],
  "description": "Time MCP Server 提供当前时间和时区时间查询工具"
}
  • 'serverName': 服务器名称，例如 "time-server"。
  • 'command': 服务器启动命令，指向 'mcp-time-js' 服务器的 'index.js' 文件路径。这里假设从项目根目录启动客户端。
  • 'args': 启动参数，本示例服务器无需参数，因此为空数组。
  • 'description': 服务器描述信息，方便客户端用户了解服务器功能。

基本使用方法

  1. 启动 MCP 服务器：

    在终端中，进入 'mcp_servers/mcp-time-js' 目录，并执行以下命令启动服务器：

    npm run start

    或者直接执行构建后的 'index.js' 文件：

    node build/index.js

    服务器成功启动后，会在控制台输出 'Time MCP Server running on stdio'。

  2. 配置 MCP 客户端：

    在 MCP 客户端应用中，根据客户端的配置方式，添加上述服务器配置信息。客户端需要能够通过 Stdio 协议与服务器进行通信。

  3. 客户端调用工具：

    客户端连接到 Time MCP Server 后，可以发送 'ListTools' 请求获取工具列表。然后，可以使用 'CallTool' 请求调用 'get-current-time' 或 'get-time-in-timezone' 工具，并根据工具的 'inputSchema' 传递必要的参数（例如时区信息）。服务器将返回包含工具执行结果的 JSON-RPC 响应。

信息

分类

开发者工具

访问项目