@findtime/mcp-server

@findtime/mcp-server は、https://time-api.findtime.io にある本番 findtime.io Time API に対する薄い stdio MCP ラッパーです。

このパッケージは、時間ロジックをローカルで再実装する代わりに、本番 API を意図的にプロキシします。現在時刻、DST、変換、重複、会議検索、ロケーション解決は、ライブ API と整合性を保つ必要があります。

公開サーフェス:

• npm: @findtime/mcp-server

• GitHub: https://github.com/hkchao/findtime-mcp-server

• 公式 MCP レジストリ: https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server

• MCP レジストリ名: io.github.hkchao/findtime-mcp-server

ツールサーフェス

• answer_time_question

• get_findtime_help

• time_snapshot

• get_current_time

• get_dst_schedule

• convert_time

• get_overlap_hours

• find_meeting_time

• search_timezones

• get_location_by_id

「3pm PST to London」「what is the IANA timezone for San Francisco?」「working hours overlap for SF, Berlin, and Tokyo」「what does CST mean?」のような複雑な自然言語プロンプトには、answer_time_question を優先してください。このツールは、findtime.io のドメインロジックを通じてプロンプトを分類し、決定的な Time API の動作にディスパッチし、世界が本当に曖昧な場合には構造化された曖昧さや明確化を返します。

Related MCP server: Time MCP Server

MCP クライアントへのインストール

公開パッケージを npx で使用します:

npx -y @findtime/mcp-server

エージェント作成者は、MCP 設定とともに SKILL.md を含めてください。 これにより、Claude、Codex、Cursor、Cline、Windsurf、カスタム企業ボット、その他の LLM エージェントに、findtime.io MCP をいつ優先するか、どのツールを呼び出すか、曖昧さやフォールバックをどう扱うかという運用ルールが提供されます。

必要なランタイム:

• Node 20+

• FINDTIME_TIME_API_KEY: https://findtime.io/developers/keys/ から取得した有効な findtime.io 開発者キー

オプションの環境変数:

• FINDTIME_TIME_API_BASE_URL

• TIME_API_BASE_URL

• TIME_API_TIMEOUT_MS

• FINDTIME_BINDING_TYPE: オプションのインストール/ワークスペースバインディングコンテキスト用。サポート値: slack_team、workspace_id、install_id。

• FINDTIME_BINDING_VALUE: 選択したバインディングタイプに一致するインストール/ワークスペース識別子。

• FINDTIME_BINDING_HEADER: カスタムエンタープライズ環境でヘッダー名を直接上書きする場合。

• FINDTIME_MCP_CLIENT_ID または FINDTIME_MCP_INSTALL_ID: 安定したクライアント識別子を提供します。省略した場合、サーバーはユーザーの状態ディレクトリの下にローカルで作成します。存在する場合、MCP ラッパーはそれを X-Findtime-User-ID として time-api に転送し、エンタープライズ利用の属性付けを行います。

• FINDTIME_MCP_CLIENT_TYPE

• FINDTIME_MCP_TOOL_MODE=answer-only: すべての自然言語リクエストを answer API 経由でルーティングするエンタープライズボット向けに、answer_time_question、get_findtime_help、get_api_diagnostics のみを公開します。

• FINDTIME_MCP_INSTRUMENTATION_ENABLED=false: 匿名使用テレメトリーをオプトアウトします。

• FINDTIME_MCP_USAGE_TELEMETRY_URL: デフォルトのテレメトリーエンドポイントを上書きします。

呼び出しごとのエンドユーザー属性付け

Slack、Discord、Teams ボットなどのマルチユーザー MCP ホストは、1 つの長期実行 @findtime/mcp-server サブプロセスを実行しながら、各 Time API 呼び出しをトリガーしたエンドユーザーに属性付けることができます。MCP ツール呼び出しの arguments オブジェクト内にオプションの _endUserId フィールドを追加します。サーバーは _endUserId をツールパラメータから取り除き、上流の X-Findtime-End-User-ID HTTP ヘッダーとしてのみ転送します。

await client.callTool({
  name: "get_current_time",
  arguments: {
    city: "Tokyo",
    _endUserId: "a3f2c1d4e5b6c7d8"
  }
});

このフィールドはオプションであり、後方互換性があります。_endUserId が欠落している場合、null、または空文字列の場合、ヘッダーは省略され、属性付けはインストールレベルの FINDTIME_MCP_CLIENT_ID または FINDTIME_MCP_INSTALL_ID の動作にフォールバックします。

プライバシー契約: _endUserId は MCP ホストが提供する不透明なトークンである必要があり、通常はプラットフォームのユーザー ID の SHA-256 ハッシュを 16〜32 文字の 16 進数に切り詰めたものです。生のメールアドレス、名前、Slack/Discord/Teams ID、その他の PII を送信しないでください。このフィールドで PII を避けることは、ホストアプリケーションの責任です。

サーバーは _endUserId を防御的に検証します: 文字列であり、最大 256 文字で、CR、LF、その他の制御文字を含んではなりません。生の値はサーバーによってログに記録されることはありません。

Cursor

{
  "mcpServers": {
    "findtime": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
      "env": {
        "FINDTIME_MCP_CLIENT_TYPE": "cursor",
        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
      }
    }
  }
}

Codex

[mcp_servers.findtime]
command = "npx"
args = ["-y", "@findtime/mcp-server"]
enabled = true

[mcp_servers.findtime.env]
FINDTIME_MCP_CLIENT_TYPE = "codex"
FINDTIME_TIME_API_BASE_URL = "https://time-api.findtime.io"
FINDTIME_TIME_API_KEY = "YOUR_FINDTIME_SECRET_KEY"
# Optional enterprise install binding:
# FINDTIME_BINDING_TYPE = "workspace_id"
# FINDTIME_BINDING_VALUE = "YOUR_WORKSPACE_ID"

Claude Desktop

{
  "preferences": {
    "...": "keep your existing preferences here"
  },
  "mcpServers": {
    "findtime": {
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
        "env": {
          "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
          "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
        }
      }
    }
  }

Claude CLI / Claude Code

findtime.io を追加:

claude mcp add --transport stdio \
  --env FINDTIME_TIME_API_BASE_URL=https://time-api.findtime.io \
  --env FINDTIME_TIME_API_KEY=YOUR_FINDTIME_SECRET_KEY \
  --env FINDTIME_MCP_CLIENT_TYPE=claude-cli \
  findtime -- npx -y @findtime/mcp-server

Claude CLI が JSON 設定を使用する場合は、代わりに追加:

{
  "mcpServers": {
    "findtime": {
      "command": "npx",
      "args": ["-y", "@findtime/mcp-server"],
      "env": {
        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY",
        "FINDTIME_MCP_CLIENT_TYPE": "claude-cli"
      }
    }
  }
}

エンタープライズインストールの場合、最小限の資格情報は常に API キーです。インストール環境に安定したワークスペースまたはインストール識別子がある場合は、オプションで追加:

FINDTIME_BINDING_TYPE=workspace_id
FINDTIME_BINDING_VALUE=YOUR_WORKSPACE_ID

Slack 固有のインストールの場合:

FINDTIME_BINDING_TYPE=slack_team
FINDTIME_BINDING_VALUE=T01ABC123

インストールの確認

まず明示的なツール呼び出しプロンプトを使用:

Use the findtime.io MCP tool get_api_diagnostics.

次に:

Use the findtime.io MCP tool get_current_time for city "Tokyo" with countryCode "JP".

それが成功したら、通常の自然言語プロンプトに戻します:

Best meeting time between New York, Sydney, and Mumbai?

ローカル開発

ワークスペースバージョンを直接実行:

npm run mcp:start

サーバーは .env.development.local、.env.development、.env.local、.env を以下から読み込もうとします:

• 現在の作業ディレクトリ

• services/mcp-server

• リポジトリルート

テスト

プロトコルおよびトランスポートテスト:

npm run test:mcp-server

ライブ本番パリティスモークテスト:

npm run test:mcp-server:smoke

スモークスイートは以下をチェックします:

• search_timezones

• answer_time_question

• get_current_time

• get_dst_schedule

• convert_time

• get_overlap_hours

• find_meeting_time

• get_location_by_id

メンテナーリリースフロー

このパッケージの正規の公開ソースは現在以下にあります:

• GitHub: https://github.com/hkchao/findtime-mcp-server

• npm: @findtime/mcp-server

• 公式 MCP レジストリ: https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server

公開とバージョン更新は、このプライベートアプリリポジトリではなく、その公開リポジトリから行う必要があります。

公開リポジトリでの標準的な公開フロー:

npm test
npm pack --dry-run
npm publish --access public

このリポジトリでの同等のローカル検証チェック:

npm run test:mcp-server
npm run mcp:pack

このリポジトリは、元々 MCP パッケージを生成した実装ソースとして扱い、正規の公開リリースソースとしては扱わないでください。