Time MCP Server

Что умеет сервер

Сервер из репозитория modelcontextprotocol/servers написан на Python и даёт агенту два инструмента. get_current_time возвращает текущее время в заданном часовом поясе или в системном и принимает название пояса по базе IANA, например America/New_York или Europe/London. convert_time переводит время из одного пояса в другой: на вход идут исходный пояс, время в 24-часовом формате HH:MM и целевой пояс.

Ответ приходит дважды: как структурированные данные и как тот же объект в виде отформатированного JSON в тексте, для клиентов, которые структурированный вывод не читают. В нём есть пояс, дата и время, день недели, признак летнего времени, а при пересчёте ещё и разница между поясами. Система сама определяет часовой пояс компьютера, его можно задать вручную аргументом --local-timezone. Сервер работает по stdio и понимает клиентов протокола 2026-07-28 и предыдущего поколения.

Когда использовать

Подключайте сервер, когда ассистент должен опираться на реальное время, а не на догадку: назначить созвон между Нью-Йорком и Токио, уточнить, который час в другом городе, перевести срок или расписание. В README приведены вопросы-образцы: «Сколько сейчас времени?», «Сколько времени в Токио?», «Когда в Нью-Йорке 16:00, сколько времени в Лондоне?», «Переведи 9:30 по Токио в нью-йоркское время».

Другие задачи, например календарь или напоминания, сервер не решает. У него нет ни промптов, ни ресурсов, списки этих методов отвечают пустыми.

Ограничения и безопасность

Название пояса должно быть точным ключом IANA, включая регистр: Europe/Warsaw принимается, а europe/warsaw отклоняется на любой платформе. Время должно быть в 24-часовом формате HH:MM, а момент, пропущенный при переводе часов, тоже считается ошибкой. Ошибка инструмента приходит как результат с признаком isError и текстом, который модель может прочитать и исправить; неизвестное имя инструмента даёт ошибку JSON-RPC -32602.

Сервер требует MCP Python SDK версии 2.x. Как и остальные серверы репозитория, он задуман как образец для обучения, а не как готовое промышленное решение. Репозиторий принимает предложения в виде обращений (issues), а не готовых pull request.

Установка

Рекомендуемый способ — uvx, отдельная установка не нужна:

uvx mcp-server-time

Через pip:

pip install mcp-server-time
python -m mcp_server_time

Claude.app

Добавьте в настройки Claude один из вариантов. Через uvx:

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
    }
  }
}

Через Docker:

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
    }
  }
}

Через установку pip:

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time"]
    }
  }
}

VS Code

Добавьте в пользовательские настройки (JSON), вызвав палитру командой Ctrl + Shift + P и Preferences: Open User Settings (JSON). Тот же блок можно положить в файл .vscode/mcp.json рабочей папки, но тогда ключ mcp обязателен.

{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["mcp-server-time"]
      }
    }
  }
}

Через Docker:

{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/time"]
      }
    }
  }
}

Свой часовой пояс по умолчанию

По умолчанию сервер определяет пояс системы. Чтобы задать свой, добавьте аргумент --local-timezone в список args:

{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

Сборка образа Docker

cd src/time
docker build -t mcp/time .