Time MCP Server

Сервер Model Context Protocol, предоставляющий возможности получения времени и конвертации часовых поясов. Этот сервер позволяет LLM получать информацию о текущем времени и выполнять конвертацию часовых поясов с использованием названий часовых поясов IANA, с автоматическим определением системного часового пояса.

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

• get_current_time - Получить текущее время в конкретном часовом поясе или системном часовом поясе.

  • Обязательные аргументы:

    • timezone (string): название часового пояса IANA (например, 'America/New_York', 'Europe/London')

• convert_time - Конвертировать время между часовыми поясами.

  • Обязательные аргументы:

    • source_timezone (string): Название исходного часового пояса IANA

    • time (string): Время в 24-часовом формате (HH:MM)

    • target_timezone (string): Название целевого часового пояса IANA

Установка

Использование uv (рекомендуется)

При использовании uv специальная установка не требуется. Мы будем использовать uvx для непосредственного запуска mcp-server-time.

uvx mcp-server-time

Использование PIP

В качестве альтернативы вы можете установить mcp-server-time через pip:

pip install mcp-server-time

После установки вы можете запускать его как скрипт, используя:

python -m mcp_server_time

Related MCP server: Time MCP Server

Конфигурация

Настройка для Claude.app

Добавьте в настройки Claude:

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

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

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

Настройка для Zed

Добавьте в ваш settings.json в Zed:

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

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
},

Настройка для VS Code

Для быстрой установки воспользуйтесь одной из кнопок установки в один клик ниже...

Для ручной установки добавьте следующий JSON-блок в ваш файл User Settings (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open User Settings (JSON).

При желании вы можете добавить его в файл с именем .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам делиться конфигурацией с другими.

Обратите внимание, что ключ mcp необходим при использовании файла mcp.json.

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

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

Настройка для Zencoder

1. Перейдите в меню Zencoder (...)

2. В раскрывающемся меню выберите Agent Tools

3. Нажмите на Add Custom MCP

4. Добавьте имя и конфигурацию сервера из приведённого ниже, и обязательно нажмите кнопку Install

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

Кастомизация - системный часовой пояс

По умолчанию сервер автоматически определяет часовой пояс вашей системы. Вы можете переопределить это, добавив аргумент --local-timezone в список args в конфигурации.

Пример:

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

Примеры взаимодействия

1. Получить текущее время:

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

Ответ:

{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

2. Конвертировать время между часовыми поясами:

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

Ответ:

{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}

Отладка

Вы можете использовать MCP inspector для отладки сервера. Для установок через uvx:

npx @modelcontextprotocol/inspector uvx mcp-server-time

Или если вы установили пакет в конкретный каталог или разрабатываете его:

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time

Примеры вопросов для Claude

1. "Который сейчас час?" (будет использоваться системный часовой пояс)

2. "Который час в Токио?"

3. "Когда в Нью-Йорке 4 часа дня, сколько времени в Лондоне?"

4. "Переведите 9:30 утра по токийскому времени в нью-йоркское время"

Сборка

Сборка Docker:

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

Вклад в проект

Мы приветствуем вклад в развитие и улучшение mcp-server-time. Хотите ли вы добавить новые инструменты, связанные со временем, расширить существующую функциональность или улучшить документацию, ваш вклад ценен.

Примеры других MCP-серверов и паттернов реализации см. на странице: https://github.com/modelcontextprotocol/servers

Пул-реквесты приветствуются! Не стесняйтесь предлагать новые идеи, исправления ошибок или улучшения, чтобы сделать mcp-server-time ещё более мощным и полезным.

Лицензия

mcp-server-time распространяется под лицензией MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение при условии соблюдения положений и условий лицензии MIT. Более подробную информацию см. в файле LICENSE в репозитории проекта.