简易时间服务 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