返回 MCP 目录
public公开dns本地运行

Time Service

MCP-Time是基于MCP协议的时间查询Node.js服务器,为AI提供精准时间服务

article

README

🚀 MCP-Time 服务器

MCP-Time 是一款基于模型上下文协议(Model Context Protocol,简称 MCP)的 Node.js 服务器,专注于处理各类时间相关查询。当大语言模型(如 Claude)在对话里碰到时间问题时,可调用该 MCP 服务器来获取精准的时间信息。

🚀 快速开始

安装与启动

  1. 安装依赖:npm install
  2. 启动服务器:npm start

✨ 主要特性

  • 获取当前时间(不同时区)
  • 获取当前日期
  • 计算日期差异
  • 格式化时间显示
  • 支持全球主要时区

📦 安装指南

依赖安装

在项目根目录下执行以下命令安装所需依赖:

npm install

启动服务器

依赖安装完成后,使用以下命令启动服务器:

npm start

💻 使用示例

基础用法

以下是一些可向 MCP-Time 服务器发起的示例查询:

  • "现在几点了?"
  • "北京时间是几点?"
  • "纽约和东京的时差是多少?"
  • "三天后是几月几号?"
  • "2023年1月1日是星期几?"

🔧 技术细节

技术栈

  • Node.js
  • @modelcontextprotocol/sdk - 官方 MCP SDK
  • 其他时间处理库

项目结构

  • index.js - 主入口文件
  • timeUtils.js - 时间处理工具函数
  • package.json - 项目配置和依赖管理
  • Dockerfile - Docker 构建配置
  • smithery.yaml - Smithery.ai 部署配置

📚 详细文档

Smithery.ai 部署说明

本项目已配置可在 Smithery.ai 平台上部署,具体配置如下:

Dockerfile

基于 Node.js 18 Alpine 镜像构建轻量级容器。

smithery.yaml

服务启动和配置选项定义:

  • defaultTimezone: 可配置默认时区,默认值为 "Asia/Shanghai"

部署步骤

  1. 在 Smithery.ai 创建新的 MCP 服务。
  2. 连接至此 GitHub 仓库。
  3. 触发部署流程。
  4. 在配置中设置所需的默认时区。

📄 许可证

文档中未提及许可证相关信息。

👨‍💻 开发者

本项目由 Claude 3.7 Sonnet 协助开发。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端