Time And Timezone

🚀 時間MCPサーバー

時間とタイムゾーンの変換機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、大規模言語モデル（LLMs）は現在の時間情報を取得し、IANAタイムゾーン名を使用してタイムゾーンを変換することができ、システムのタイムゾーンを自動検出することもできます。

🚀 クイックスタート

時間MCPサーバーは、大規模言語モデルに時間とタイムゾーンの変換機能を提供します。以下に、利用可能なツールやインストール方法、設定ガイドなどを説明します。

✨ 主な機能

• 時間取得：get_current_time ツールを使用して、特定のタイムゾーンまたはシステムのタイムゾーンの現在の時間を取得できます。
• 時間変換：convert_time ツールを使用して、異なるタイムゾーン間で時間を変換できます。
• 自動タイムゾーン検出：サーバーはシステムのタイムゾーンを自動検出しますが、必要に応じて手動で指定することもできます。

利用可能なツール

• get_current_time - 特定のタイムゾーンまたはシステムのタイムゾーンの現在の時間を取得します。

  • 必須パラメータ：
    • timezone (文字列): IANAタイムゾーン名（例: 'America/New_York', 'Europe/London'）

• convert_time - 異なるタイムゾーン間で時間を変換します。

  • 必須パラメータ：
    • source_timezone (文字列): 元のIANAタイムゾーン名
    • time (文字列): 24時間制の時間形式（HH:MM）
    • target_timezone (文字列): 目標のIANAタイムゾーン名

📦 インストール

uvを使用する（推奨）

uv を使用する場合、特別なインストールは必要ありません。uvx を直接使用して mcp-server-time を実行します。

pipを使用してインストールする

または、pipを使用して time-mcp-local をインストールすることができます。

pip install time-mcp-local

インストールが完了したら、以下のコマンドを使用してスクリプトとして実行できます。

python -m time-mcp-local

📚 ドキュメント

Claude.app用の設定

Claudeの設定に以下の内容を追加します。

"mcpServers": {
  "time": {
    "command": "uvx",
    "args": ["time-mcp-local"]
  }
}

"mcpServers": {
  "time": {
    "command": "python",
    "args": ["-m", "time_mcp_local"]
  }
}

Zed用の設定

Zedのsettings.jsonに以下の内容を追加します。

"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["time-mcp-local"]
  }
}

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "time_mcp_local"]
  }
}

カスタム設定

デフォルトでは、このサーバーはシステムのタイムゾーンを自動検出します。デフォルトの動作を上書きする必要がある場合は、以下のコマンドでタイムゾーンを指定できます。

uv run --env TZ=Asia/Shanghai time-mcp-local

💻 使用例

現在の時間を取得する

リクエスト：

{
  "id": "123",
  "procedure": {
    "fn_ref": "get_current_time"
  }
}

レスポンス：

{
  "id": "123",
  "result": {
    "time": "現在の時間",
    "timestamp": "Unixタイムスタンプ"
  }
}

時間を変換する

リクエスト：

{
  "id": "456",
  "procedure": {
    "fn_ref": "convert_time",
    "args": ["source_timezone", "target_timezone"]
  }
}

レスポンス：

{
  "id": "456",
  "result": {
    "converted_time": "変換後の時間"
  }
}

🔧 技術詳細

デバッグ

サーバーをデバッグするには、以下のコマンドを使用します。

uv run time-mcp-local --inspect

パッケージのビルドと公開

パッケージをビルドして公開するには、以下のコマンドを実行します。

uv build --wheel
uv publish --token xxx