mcp-time

MCP Time Server

日付と時刻に関連するツールを提供する Model Context Protocol（MCP）サーバーです。デュアルモードに対応しています。

• Stdio トランスポート：ローカルの MCP クライアント向け（npm 経由）
• Streamable HTTP トランスポート：リモートアクセス向け（Cloudflare Workers 経由）

このサーバーを使うと、LLM は複数の接続方法を通じて、さまざまな日付／時刻関数にアクセスできます。

MCP Central Server Card: https://guide-gen.mcpcentral.io/servers/io-github-mcpcentral-io-mcp-time

機能

以下の MCP ツールを提供します。

• current_time：指定した形式とタイムゾーンで現在の日付と時刻を取得します。
• relative_time：人が読みやすい相対時刻の文字列（例：「5 分後」、「2 時間前」）を取得します。
• days_in_month：指定した月の日数を取得します。
• get_timestamp：指定した時刻の Unix タイムスタンプ（ミリ秒）を取得します。
• convert_time：異なる IANA タイムゾーン間で時刻を変換します。
• get_week_year：指定した日付の週番号と ISO 週番号を取得します。

プロジェクト構成

mcp-time/
├── src/
│   └── index.ts      # Cloudflare Worker entry point & MCP logic
├── package.json      # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── wrangler.toml     # Cloudflare Worker configuration

インストール

オプション 1：npm からインストール（Stdio モード）

パッケージをグローバルにインストールするか、npx で使用します。

# Global installation
npm install -g @mcpcentral/mcp-time

# Or use directly with npx
npx @mcpcentral/mcp-time

オプション 2：リモートサーバーを使用（HTTP モード）

デプロイ済みの Cloudflare Worker に直接接続します。

例：

https://mcp.time.mcpcentral.io

使用方法

Stdio トランスポート（ローカル）

MCP クライアント（Claude Desktop など）を設定して、stdio トランスポートを使用します。

{
  "mcpServers": {
    "time-server": {
      "command": "npx",
      "args": ["@mcpcentral/mcp-time"]
    }
  }
}

または、グローバルインストールを使用します。

{
  "mcpServers": {
    "time-server": {
      "command": "/path/to/node/bin/mcp-time"
    }
  }
}

Streamable HTTP トランスポート（リモート）

MCP クライアントを設定して、リモート HTTP エンドポイントを使用します。

{
  "mcpServers": {
    "time-server": {
      "url": "https://mcp.time.mcpcentral.io",
      "transport": "streamable-http"
    }
  }
}

開発

1. リポジトリをクローンする：

   git clone https://github.com/mcpcentral-io/mcp-time.git
   cd mcp-time
   

2. 依存関係をインストールする：

   npm install
   

3. ビルドする： TypeScript コードをコンパイルします。

   npm run build
   

   （これにより、src/index.ts が dist/index.js にコンパイルされます）

4. ローカルでテストする：

   Stdio モードをテストする：

   echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js
   

   HTTP モードをテストする（Wrangler 経由）：

   npx wrangler dev
   

   サーバーが http://localhost:8787 で起動します。その後、curl でテストするか、MCP クライアントからこのローカルエンドポイントに接続できます。

デプロイ

Cloudflare Workers にデプロイする（HTTP モード）

1. Cloudflare を設定する：

   cp wrangler.toml.example wrangler.toml
   

   wrangler.toml を編集して、ドメインを設定します（任意）。

2. ログインしてデプロイする：

   wrangler login
   npx wrangler deploy
   

npm に公開する（Stdio モード）

1. パッケージをビルドする：

   npm run build
   

2. 公開する：

   npm publish --access public
   

Streamable HTTP サーバー向けコネクター

新着：主要プロバイダーは Model Context Protocol を採用し、Streamable HTTP サーバーを直接サポートするようになりました。Anthropic、OpenAI、Microsoft はいずれも、この最新のトランスポートプロトコルを採用しています。

📋 プロトコルに関する注意：Streamable HTTP は、非推奨となった HTTP+SSE トランスポートに代わる最新の方式です。

Anthropic MCP Connector

Anthropic の MCP Connector を使うと、別途 MCP クライアントを用意せずに、Messages API を通じて Streamable HTTP サーバーを直接利用できます。

このサーバーは Streamable HTTP アーキテクチャを採用しているため、MCP Connector に最適です。API リクエストにサーバーを含めるだけで利用できます。

curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-04-04" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1000,
    "messages": [{
      "role": "user", 
      "content": "What time is it in Tokyo?"
    }],
    "mcp_servers": [{
      "type": "url",
      "url": "https://your.worker.url.workers.dev",
      "name": "http-time-server"
    }]
  }'

Anthropic MCP Connector のメリット：

• クライアントのセットアップが不要 — API を通じて直接接続できます
• Streamable HTTP をネイティブサポート — このようなサーバー向けに設計されています

OpenAI Agents SDK

OpenAI も、Agents SDK の MCPServerStreamableHttp クラスを使って、Streamable HTTP サーバーをサポートしています。

from agents.mcp.server import MCPServerStreamableHttp

# Connect to this Streamable HTTP server
server = MCPServerStreamableHttp({
    "url": "https://your.worker.url.workers.dev",
    "headers": {"Authorization": "Bearer your-token"},  # if needed
})

# Use the server in your OpenAI agent
await server.connect()
tools = await server.list_tools()
result = await server.call_tool("current_time", {"timezone": "Asia/Tokyo"})

Microsoft Copilot Studio

Microsoft Copilot Studio は、Streamable HTTP サーバーに対応し、MCP 連携が一般提供されています。次の方法で、このサーバーを Copilot Studio に接続できます。

1. カスタムコネクタを構築することで、MCP サーバーを Copilot Studio に接続します
2. Copilot Studio でツールを追加するには、「Add a Tool」を選択し、MCP サーバーを検索します
3. 生成的なオーケストレーションを有効にして、エージェントでサーバーを直接使用する

今後追加される MCP クライアント

今後、さらに多くの MCP クライアントが Streamable HTTP に対応する予定です。MCP クライアントとその機能の一覧を掲載しているリソースをいくつか紹介します。

• PulseMCP Client Directory - MCP クライアントの包括的な一覧
• Official MCP Servers Repository - クライアント情報を含む公式コレクション
• MCP.so Client Listings - コミュニティが管理するクライアントディレクトリ

テストと検証

MCP Inspector ツール（HTTP モード）

次のウェブベースの検査ツールを使って、サーバーをテストできます。

MCPCentral Tools（推奨）

• MCPCentral Lab - MCP サーバーの対話型テスト環境
• MCPCentral Inspector - Streamable HTTP サーバーのインスペクター

公式 MCP Inspector

公式の MCP Inspector も利用できます。

• 次のページにアクセスします：https://github.com/modelcontextprotocol/inspector
• または、次を実行します：npx @modelcontextprotocol/inspector

テスト手順

1. サーバーを起動します：

   # Local HTTP server
   npx wrangler dev
   
   # Or use deployed URL: https://mcp.time.mcpcentral.io
   

2. インスペクターに接続します：

   • トランスポート：Streamable HTTP
   • URL：http://localhost:8787 または https://mcp.time.mcpcentral.io
   • Connect をクリックします

コマンドラインでのテスト（Stdio モード）

stdio トランスポートを直接テストします。

# Test initialization
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | npx @mcpcentral/mcp-time

# Test tool call
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"current_time","arguments":{"timezone":"America/New_York"}}}' | npx @mcpcentral/mcp-time

テスト可能なツール

インスペクターには、時間に関する 6 つのツールがすべて表示されます。

• current_time：さまざまなタイムゾーン（例：「America/New_York」、「Europe/London」）でテストします
• relative_time：さまざまな時刻文字列（例：「2024-12-25T00:00:00Z」）でテストします
• days_in_month：さまざまな月と年でテストします
• get_timestamp：日時文字列を Unix タイムスタンプに変換します
• convert_time：異なるタイムゾーン間で変換します
• get_week_year：特定の日付の週番号を取得します

テストケースの例

次のテストケースをインスペクターで試してください。

// current_time
{"timezone": "Asia/Tokyo", "format": "iso"}

// relative_time  
{"time": "2024-12-25T00:00:00Z"}

// days_in_month
{"month": 2, "year": 2024}

// get_timestamp
{"time": "2024-06-15T12:00:00Z"}

// convert_time
{"time": "2024-06-15T12:00:00", "from": "UTC", "to": "America/Los_Angeles"}

// get_week_year
{"date": "2024-06-15"}

検証チェックリスト

インスペクターを使って、次の項目を確認します。

• ✅ サーバーに正常に接続できる
• ✅ 6 つのツールがすべて表示される
• ✅ ツールのスキーマが正しく定義されている
• ✅ ツールがエラーなく実行される
• ✅ 結果が正しくフォーマットされている
• ✅ 無効な入力に対するエラー処理が機能する

MCP Inspector は、AI クライアントと連携する前にサーバーをテストするための、最も包括的な方法を提供します。

---

認証とセキュリティに関する考慮事項

⚠️ 重要：このサンプルサーバーには、認証やセキュリティ対策が一切実装されていません。