Simple Time MCP Server

🚀 用于时间服务的简单MCP服务器

本项目提供了一个简单的MCP（方法调用协议）服务器，可用于获取当前时间。该服务器基于JSON - RPC 2.0协议实现方法调用，能满足基本的时间查询需求。

🚀 快速开始

本部分将引导您完成服务器的安装与启动。

📦 安装指南

按照以下步骤克隆仓库并安装依赖项：

# 克隆仓库
git clone https://github.com/Anragde/simple-time-mcp-server.git
cd simple-time-mcp-server

# 安装依赖项
npm install

启动服务器

启动服务器有开发和生产两种模式：

# 在开发模式下启动（带热重载）
npm run dev

# 在生产模式下启动
npm start

服务器默认在端口3000启动，您可通过设置PORT环境变量来修改端口。

💻 使用示例

基础用法

服务器通过 /mcp 端点提供了多个方法，以下是各方法的使用示例：

1. getCurrentTime

此方法用于返回当前时间，并可按指定格式显示。 参数：

• format（可选）：时间格式（使用moment.js的格式），默认值为 'YYYY - MM - DD HH:mm:ss'。

示例请求：

{
  "jsonrpc": "2.0",
  "method": "getCurrentTime",
  "params": {
    "format": "HH:mm:ss"
  },
  "id": 1
}

示例响应：

{
  "jsonrpc": "2.0",
  "result": {
    "time": "14:30:45",
    "timestamp": 1616929845123
  },
  "id": 1
}

2. getTimeInTimezone

该方法用于返回指定时区的当前时间。 参数：

• timezone（必需）：时区（例如：'Europe/Paris', 'America/New_York'）
• format（可选）：时间格式，默认值为 'YYYY - MM - DD HH:mm:ss'。

示例请求：

{
  "jsonrpc": "2.0",
  "method": "getTimeInTimezone",
  "params": {
    "timezone": "Europe/Paris",
    "format": "ddd, DD MMM YYYY HH:mm:ss"
  },
  "id": 2
}

示例响应：

{
  "jsonrpc": "2.0",
  "result": {
    "time": "Mon, 28 Mar 2025 14:30:45",
    "timezone": "Europe/Paris",
    "timestamp": 1616929845123
  },
  "id": 2
}

服务器状态检查

您可以使用 /health 端点检查服务器的运行状态。 示例请求：

curl http://localhost:3000/health

示例响应：

{
  "status": "ok", 
  "timestamp": 1616929845123
}

📄 许可证

本项目采用MIT许可证。