🚀

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

Name: 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities
Author: yokingma

本地服务

github.com/yokingma生产力7239 周前更新

代码仓库

关于 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

Time MCP Server 是一个为 LLM 提供时间感知能力的 MCP 服务，可获取当前时间、时区转换、相对时间和日历相关信息。适合需要让 AI 助手准确处理时间与日期的用户。

主要功能

01获取 UTC 与本地当前时间
02在不同时区之间转换时间
03计算相对时间与时间戳
04查询指定月份的天数
05获取周数与 ISO 周信息

适用场景

01让 AI 助手回答当前时间或日期相关问题
02在不同时区之间换算会议时间
03查询某月天数或某年的周数

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 current_time、relative_time、get_timestamp、days_in_month、convert_time 和 get_week_year 等工具。

#agents #llm #mcp-server #time-mcp

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": [
        "-y",
        "time-mcp"
      ]
    }
  }
}

启动命令npx -y time-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtime-mcp1.0.6stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
format	enum	否	时间的格式h:mm A \| h:mm:ss A \| YYYY-MM-DD HH:mm:ss \| YYYY-MM-DD \| YYYY-MM \| MM/DD/YYYY \| MM/DD/YY \| YYYY/MM/DD \| YYYY/MM
timezone	string	否	时间所用的时区，IANA 时区名称，例如 Asia/Shanghai

详细介绍

🚀 Time MCP 服务：为大模型赋予时间感知能力

一个 Model Context Protocol (MCP) 服务实现，让大模型具备时间感知能力。

工具

current_time：获取当前时间（UTC 和本地时间）
relative_time：获取相对时间
get_timestamp：获取指定时间的时间戳
days_in_month：获取指定月份的天数
convert_time：在不同时区之间转换时间
get_week_year：获取一年中的周数和 ISO 周数

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 time-mcp：

npx -y @smithery/cli install @yokingma/time-mcp --client claude

手动安装（可选）

npm install -g time-mcp

使用 npx

npx -y time-mcp

在 Claude Code 中运行

要将 time-mcp 添加到 Claude Code，请使用以下命令：

claude mcp add time-mcp -- npx -y time-mcp

验证安装：

claude mcp list

你应该会看到 time-mcp 已列出，状态为 ✓ Connected。

在 Claude Code 中使用

安装后，你可以在与 Claude Code 的对话中使用 time-mcp 工具。例如：

“现在几点？”
“将纽约时间下午 2:00 转换为东京时间”
“这个月有多少天？”
“现在是一年中的第几周？”

time-mcp 服务会自动向 Claude 提供准确的时间信息。

在 Cursor 中运行

你的 mcp.json 文件应如下所示：

{
  "mcpServers": {
    "time-mcp": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    }
  }
}

在 Windsurf 中运行

将以下内容添加到 ./codeium/windsurf/model_config.json 文件中：

{
  "mcpServers": {
    "time-mcp": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    }
  }
}

许可证

MIT 许可证——详情请参阅 LICENSE 文件。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。