Time

Time MCP Server

時刻およびタイムゾーン変換機能を提供する 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 を直接実行します。

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", "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"]
  }
},

カスタマイズ — システムのタイムゾーン

デフォルトでは、サーバーがシステムのタイムゾーンを自動検出します。設定の 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 ファイルをご覧ください。