time-mcp-server

Time MCP サーバー

時刻とタイムゾーンの変換機能を提供する Model Context Protocol サーバーです。このサーバーを使用すると、LLM は現在時刻の情報を取得し、IANA タイムゾーン名を使ってタイムゾーンを変換できます。また、システムのタイムゾーンを自動的に検出します。

利用可能なツール

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

  • 必須の引数：
    • timezone（string）：IANA タイムゾーン名（例：'America/New_York'、'Europe/London'）

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

  • 必須の引数：
    • source_timezone（string）：変換元の IANA タイムゾーン名
    • time（string）：24 時間形式の時刻（HH:MM）
    • target_timezone（string）：変換先の IANA タイムゾーン名

インストール

uv を使用する（推奨）

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

uvx mcp-server-time

PIP を使用する

または、pip を使用して mcp-server-time をインストールできます。

pip install mcp-server-time

インストール後、次のコマンドをスクリプトとして実行できます。

python -m mcp_server_time

設定

Claude.app 用の設定

Claude の設定に追加します。

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

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
    }
  }
}

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

Zed 用の設定

Zed の settings.json に追加します。

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

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

VS Code 用の設定

すばやくインストールするには、以下のワンクリックインストールボタンのいずれかを使用します……

手動でインストールするには、次の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力すると開けます。

任意で、ワークスペース内の .vscode/mcp.json という名前のファイルに追加することもできます。これにより、設定をほかのユーザーと共有できます。

mcp.json ファイルを使用する場合は、mcp キーが必要です。

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

{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/time"]
      }
    }
  }
}

Zencoder 用の設定

1. Zencoder メニュー（...）を開きます
2. ドロップダウンメニューから Agent Tools を選択します
3. Add Custom MCP をクリックします
4. 以下の名前とサーバー設定を追加し、必ず Install ボタンをクリックします

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

デフォルトでは、サーバーはシステムのタイムゾーンを自動的に検出します。設定の args リストに引数 --local-timezone を追加すると、これを上書きできます。

例：

{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

やり取りの例

1. 現在の時刻を取得する：

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

応答：

{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

2. タイムゾーン間で時刻を変換する：

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

応答：

{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}

デバッグ

MCP Inspector を使ってサーバーをデバッグできます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector uvx mcp-server-time

または、パッケージを特定のディレクトリにインストールした場合や、開発中の場合：

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time

Claude への質問例

1. 「今は何時ですか？」（システムのタイムゾーンを使用します）
2. 「東京は今何時ですか？」
3. 「ニューヨークが午後4時のとき、ロンドンは何時ですか？」
4. 「東京時間の午前9時30分をニューヨーク時間に変換してください」

ビルド

Docker ビルド：

cd src/time
docker build -t mcp/time .

コントリビューション

mcp-server-time の拡張と改善に役立つコントリビューションを歓迎します。新しい時刻関連ツールの追加、既存機能の強化、ドキュメントの改善など、皆さまからのご提案は貴重です。

ほかの MCP サーバーや実装パターンの例については、以下をご覧ください： https://github.com/modelcontextprotocol/servers

プルリクエストを歓迎します！mcp-server-time をさらに強力で便利なものにするため、新しいアイデアやバグ修正、機能強化をぜひお寄せください。

ライセンス

mcp-server-time は MIT License の下でライセンスされています。MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。