MCP-инструменты для работы с датой и временем

Сервер протокола контекста модели (MCP) для манипуляций с датой и временем и преобразования часовых поясов.

Обзор

Этот MCP-сервер предоставляет набор инструментов для работы со строками даты и времени, включая преобразование часовых поясов, изменение даты (арифметические операции) и получение текущей даты, времени и часового пояса. Он разработан как серверная утилита для приложений или агентов, которым требуются надежные и стандартизированные операции с датой и временем.

Рабочая версия: https://date-time-tools.iabhishek.workers.dev/mcp

Related MCP server: Time MCP Server

Архитектура

Этот сервер работает на Cloudflare Workers и использует транспорт Streamable HTTP (также доступна устаревшая конечная точка SSE). Состояние сеанса поддерживается объектом Durable Object через обертку McpAgent из пакета agents для Cloudflare.

Конечные точки:

• POST/GET/DELETE /mcp — транспорт Streamable HTTP. Сеансы отслеживаются через заголовок mcp-session-id.

• GET /sse, POST /sse/message — устаревший транспорт SSE для старых клиентов.

Локальная разработка

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

Развертывание в Cloudflare

Вручную

Однократная настройка:

npx wrangler login

Развертывание:

npm run deploy

Wrangler выведет публичный URL — для этого проекта это https://date-time-tools.iabhishek.workers.dev/mcp. Бесплатный тарифный план Workers покрывает этот сервер (100 тыс. запросов в день; бесплатный уровень Durable Objects покрывает хранилище сеансов).

Автоматизированное (GitHub Actions)

Файл .github/workflows/deploy.yml выполняет развертывание при каждом пуше в ветку main (а также при ручном запуске workflow_dispatch). Настройте два секрета репозитория:

• CLOUDFLARE_API_TOKEN — создайте на странице https://dash.cloudflare.com/profile/api-tokens, используя шаблон Edit Cloudflare Workers

• CLOUDFLARE_ACCOUNT_ID — находится на боковой панели панели управления Workers & Pages

Интеграция с MCP-клиентами

Claude Code

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

Добавьте --scope user, чтобы зарегистрировать его для каждого проекта, или --scope project, чтобы зафиксировать файл .mcp.json, общий для всех участников. Проверьте с помощью claude mcp list; внутри Claude Code выполните /mcp, чтобы проверить статус и инструменты.

Универсальные клиенты Streamable HTTP

Настройте клиенты, поддерживающие транспорт Streamable HTTP, на развернутый URL:

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

Для клиентов, которые поддерживают только stdio, используйте мост mcp-remote:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

Доступные инструменты

Этот MCP-сервер предоставляет следующие инструменты для LLM:

• convertTimezones: Преобразование строки даты и времени из одного часового пояса в другой.

• mutateDate: Сложение или вычитание дней, часов, минут, месяцев или лет из строки даты и времени.

• currentDateTimeAndTimezone: Получение текущей даты, времени и часового пояса.

🧪 Тестирование с помощью MCP Inspector

Выполните npm run dev, затем в другом терминале:

npx -y @modelcontextprotocol/inspector

Выберите транспорт Streamable HTTP и используйте http://127.0.0.1:8787/mcp в качестве URL.

Функции

• Преобразование часовых поясов
  Преобразование строки даты и времени из одного часового пояса IANA в другой с использованием форматов, совместимых с Luxon.

• Изменение даты
  Сложение или вычитание дней, часов, минут, месяцев или лет из строки даты и времени.

• Текущая дата, время и часовой пояс
  Получение текущей даты, времени и часового пояса пользователя/системы.