关键词

时间时区工具JavaScriptStdio

使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的时间服务服务器，使用 JavaScript 开发。它提供了一组工具，允许 MCP 客户端查询当前时间以及特定时区的时间。

主要功能点

  • 获取当前时间：提供工具获取当前时间的 ISO 格式、本地格式或 Unix 时间戳。
  • 获取时区时间：提供工具获取指定时区的当前时间，支持 ISO 或本地格式。
  • 标准 MCP 协议：使用 JSON-RPC over Stdio 实现 MCP 协议，易于集成到支持 MCP 协议的客户端。

安装步骤

  1. 进入目录：在您的终端中，导航到仓库的 'mcp_servers/mcp-time-js' 目录： 
    cd mcp_servers/mcp-time-js
  2. 安装依赖：运行 'npm install' 命令安装项目依赖： 
    npm install
  3. 构建服务器：运行 'npm run build' 命令构建服务器代码： 
    npm run build
    构建成功后，会在 'mcp_servers/mcp-time-js/build' 目录下生成可执行的服务器文件 'index.js'。

服务器配置

对于 MCP 客户端，您需要配置连接到此 MCP 服务器的信息。以下是一个 JSON 格式的配置示例，您需要将其配置到您的 MCP 客户端中：

{
  "serverName": "time-server",
  "command": "mcp_servers/mcp-time-js/build/index.js",
  "args": [],
  "description": "提供时间相关工具的 MCP 服务器",
  "capabilities": {
    "tools": true
  },
  "transport": "stdio"
}

配置参数说明：

  • 'serverName': 服务器名称，可以自定义，例如 "time-server"。
  • 'command': MCP 服务器的启动命令。这里指向构建后的 'index.js' 文件，请确保路径正确。
  • 'args': 启动命令的参数。本服务器不需要额外的启动参数，所以配置为空数组 '[]'。
  • 'description': 服务器的描述信息，方便客户端用户理解其用途。
  • 'capabilities': 声明服务器提供的能力，本服务器提供工具 (tools) 功能，所以设置为 '{"tools": true}'。
  • 'transport': 声明服务器使用的传输协议，本服务器使用 Stdio，所以设置为 '"stdio"'。

注意：

  • 确保您的 MCP 客户端能够执行 Node.js 环境下的 JavaScript 文件。
  • 'command' 路径需要根据您的实际文件位置进行调整。

基本使用方法

  1. 启动服务器：在终端中，导航到 'mcp_servers/mcp-time-js' 目录，并运行以下命令启动服务器：

    npm start

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

    node build/index.js

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

  2. 客户端连接和使用：配置您的 MCP 客户端，使用上面提供的服务器配置信息连接到时间服务 MCP 服务器。连接成功后，您可以使用客户端提供的界面或 API 调用服务器提供的工具，例如：

    • 调用 'get-current-time' 工具获取当前时间。
    • 调用 'get-time-in-timezone' 工具并传入 'timezone' 参数（例如 "America/New_York"）获取特定时区的时间。

    具体的工具调用方法和参数请参考 MCP 客户端的使用文档。

信息

分类

开发者工具

访问项目