Timeapi Io

@pipeworx/timeapi-io

TimeAPI.io MCP — API キー不要の現在時刻、タイムゾーン変換、DST の照会。

Pipeworx の一部です — AI エージェントを 1684+ のライブデータソースにつなぐ MCP ゲートウェイです。

ツール

• current_time(timeZone) — 指定したタイムゾーンの現在時刻
• current_time_coordinate(latitude, longitude) — 緯度・経度で指定した場所の現在時刻
• current_time_ip(ipAddress) — IP アドレスの現在時刻
• current_iso_zoned_date_time(timeZone) — ISO 形式のタイムゾーン付き日時
• current_zone_info(timeZone) — タイムゾーン情報（DST フラグ、UTC オフセット）
• convert_time_zone(fromTimeZone, dateTime, toTimeZone, dstAmbiguity?) — タイムゾーン間の変換
• day_of_the_week(date) — 指定した日付の曜日
• list_zones() — 対応しているタイムゾーン
• translate_to_iso(date, format) — カスタム形式の日付を ISO 形式に変換

データソース

https://timeapi.io/api

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "timeapi-io": {
      "url": "https://gateway.pipeworx.io/timeapi-io/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/timeapi-io/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で共通のツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、そのパック固有のツールとともに、共通ツールがおよそ 30 個表示されます。接続の initialize 応答には正確な対象範囲が示され、その日の情報として信頼できる回答になります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックでは扱えない質問にも、カタログ全体を対象に処理を振り分ける ask_pipeworx を介して回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1684+ のデータソースにつながります。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/current_time \
  -H 'Content-Type: application/json' \
  -d '{"timeZone":"America/New_York"}'

最初の呼び出しにアカウントは必要ありません。ツールを調べるには、GET https://gateway.pipeworx.io/v1/tools/current_time を使用します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイ経由の通信も不要です：

{
  "mcpServers": {
    "timeapi-io": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-timeapi-io"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-timeapi-io

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールはありません。同じデータソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Timeapi Io data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT