Time MCP Server 使用说明

项目简介

Time MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 提供时间感知能力。通过集成此服务器，LLM 可以获取各种时间相关的信息，从而在需要时间上下文的任务中表现更出色。

主要功能点

• 获取当前时间: 允许LLM查询并获取当前日期和时间，支持多种时间格式。
• 获取相对时间: 能够计算并返回相对于指定时间的时间差，例如 "几分钟前"、"几天后" 等。
• 获取时间戳: 提供将特定时间转换为时间戳的功能。
• 获取月份天数: 可以查询指定日期所在月份的天数。

安装步骤

1. 使用 npm (可选全局安装):

   npm install -g time-mcp
   

   或
2. 使用 npx (推荐): 无需全局安装，直接运行：

   npx -y time-mcp
   

服务器配置

对于 MCP 客户端 (如 Cursor, Windsurf 等)，您需要配置 'mcpServers' 以连接 Time MCP Server。以下是配置示例：

Cursor 'mcp.json' 配置:

{
  "mcpServers": {
    "time-mcp": {  // 服务器名称，客户端内唯一标识
      "command": "npx", // 启动服务器的命令，这里使用 npx 运行
      "args": ["-y", "time-mcp"] // 命令参数，-y 表示自动确认执行
    }
  }
}

Windsurf 'model_config.json' 配置:

{
  "mcpServers": {
    "time-mcp": {  // 服务器名称，客户端内唯一标识
      "command": "npx", // 启动服务器的命令，这里使用 npx 运行
      "args": ["-y", "time-mcp"] // 命令参数，-y 表示自动确认执行
    }
  }
}

配置说明:

• '"time-mcp"': 是您为该时间服务器定义的名称，在客户端配置中用于引用。
• '"command": "npx"' 和 '"args": ["-y", "time-mcp"]': 指定了启动 Time MCP Server 的命令。'npx -y time-mcp' 会查找并执行 'time-mcp' 包。

基本使用方法

1. 启动服务器: 根据您的MCP客户端的配置方式启动 Time MCP Server。通常客户端会自动启动配置的 MCP 服务器。
2. 在 LLM 中调用工具: 在支持 MCP 协议的 LLM 应用中，您可以指示 LLM 调用 Time MCP Server 提供的工具。例如，您可以指示 LLM 使用 'current_time' 工具获取当前时间，或者使用 'relative_time' 工具计算时间差。

工具调用示例 (在支持 MCP 的 LLM 客户端中，通过自然语言指示 LLM 调用工具):

• "现在几点了？" (LLM 可能会调用 'current_time' 工具来获取当前时间)
• "昨天下午三点到现在过去多久了？" (LLM 可能会调用 'relative_time' 工具来计算相对时间)
• "2024年2月有多少天？" (LLM 可能会调用 'days_in_month' 工具来查询月份天数)

LLM 客户端会根据您的指令，自动与 Time MCP Server 通信，调用相应的工具并返回结果。