IoEHub MCP Time Server

IoEHub MCP Time Server

現在の Unix タイムスタンプを提供する、堅牢な MCP（Model Context Protocol）タイムサーバーです。このサーバーは MCP プロトコルを実装し、現在時刻にアクセスできない AI モデルに時刻情報を提供します。

機能

• 高い信頼性：標準入力／標準出力の接続が閉じられても、稼働を続けられるように設計されています
• 包括的なロギング：トラブルシューティング用に、標準エラー出力とファイルの両方にログを記録します
• 自己回復機能：終了要求に耐え、可用性を維持します
• 豊富な時刻情報：複数の形式で時刻データを提供します
• MCP プロトコル準拠：Claude、Cursor、その他の MCP クライアントと完全に互換性があります

インストールと使用方法

サーバーは複数の方法で起動できます。

方法 1：バッチファイルを使用する（Windows での推奨方法）

start-mcp-server.bat

これにより、サーバーがバックグラウンドモードで起動し、独立して実行されます。

方法 2：node コマンドを直接実行する

node ioehub-time.js

方法 3：npm を使用する

npm install
npm start

プロトコルのサポート

このサーバーは Model Context Protocol（MCP）を実装し、次のメソッドをサポートしています。

• initialize：機能を指定してサーバーを初期化します
• getTime：さまざまな形式で現在時刻を取得します
• shutdown：サーバーを正常にシャットダウンします（実際にはサーバーは稼働を続けます）

時刻レスポンス形式

サーバーは次の形式で時刻情報を提供します。

{
  "unix_time": 1713258180,
  "unix_ms": 1713258180123,
  "human_readable": "2024-04-16T09:36:20.000Z",
  "formatted": "4/16/2024, 5:36:20 PM",
  "utc": "Tue, 16 Apr 2024 09:36:20 GMT",
  "date_only": "Tue Apr 16 2024",
  "time_only": "09:36:20 GMT+0000 (Coordinated Universal Time)"
}

ロギング

ログは標準エラー出力と logs ディレクトリ内のログファイルの両方に書き込まれます。サーバーの各インスタンスはタイムスタンプ付きの新しいログファイルを作成するため、問題を簡単にトラブルシューティングできます。

AI プラットフォームとの統合

MCP の設定

次の JSON 形式を使用して、MCP 設定にタイムサーバーを追加します。

{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "cmd",
      "args": [
        "/c",
        "C:\\path\\to\\your\\ioehub-mcp-time-server\\start-mcp-server.bat"
      ]
    }
  }
}

Unix/Linux/macOS 環境の場合：

{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "node",
      "args": [
        "/path/to/your/ioehub-mcp-time-server/ioehub-time.js"
      ]
    }
  }
}

Claude での使用方法

Claude AI は現在時刻に直接アクセスできません。IoEHub MCP Time Server を Claude と統合するには、次の手順に従います。

1. MCP 設定で IoEHub MCP Time Server をセットアップします。

{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "cmd",
      "args": [
        "/c",
        "C:\\path\\to\\your\\ioehub-mcp-time-server\\start-mcp-server.bat"
      ]
    }
  }
}

2. Claude は MCP プロトコルを介してタイムサーバーに自動的にアクセスできるようになります。関数呼び出しを通じて、時刻情報に直接アクセスできます。

I need to get the current time.

Cursor での使用方法

Cursor IDE は、タイムスタンプが必要な AI 支援コーディングで IoEHub MCP Time Server を活用できます。

1. プロジェクト設定で IoEHub MCP Time Server を設定します。

{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "cmd",
      "args": [
        "/c",
        "C:\\path\\to\\your\\ioehub-mcp-time-server\\start-mcp-server.bat"
      ]
    }
  }
}

2. Cursor は MCP プロトコルを通じて現在時刻情報に自動的にアクセスできるようになります。

トラブルシューティング

問題が発生した場合：

1. logs ディレクトリ内のログファイルを確認します
2. 競合する可能性がある他の Node.js プロセスが実行されていないことを確認します
3. MCP 設定で正しいファイルパスが指定されていることを確認します