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許可證。