Simple Time MCP Server

🚀 時間サービス用のシンプルなMCPサーバー

このリポジトリには、現在の時間を取得するサービスを提供するシンプルなMCP（メソッド呼び出しプロトコル）サーバーが含まれています。このサーバーは、メソッド呼び出しにJSON - RPC 2.0プロトコルを実装しています。

🚀 クイックスタート

このシンプルなMCPサーバーを使用することで、簡単に現在の時間を取得することができます。以下の手順に従ってサーバーをセットアップしてください。

📦 インストール

# リポジトリをクローンする
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