Time MCP

🚀 Time MCP Server: Empowering Large Language Models with Time Awareness

This is an implementation of a Model Context Protocol (MCP) server that endows large language models with time awareness.

🚀 Quick Start

This project is an implementation of a Model Context Protocol (MCP) server, which aims to empower large language models with time awareness.

✨ Features

• current_time: Get the current time (UTC and local time).
• relative_time: Get relative time.
• get_timestamp: Get the timestamp.
• days_in_month: Get the number of days in a month.
• convert_time: Convert time between time zones.
• get_week_year: Get the week in the year and the ISO week.

📦 Installation

Install via Smithery

To automatically install time-mcp for Claude Desktop, use Smithery:

npx -y @smithery/cli install @yokingma/time-mcp --client claude

Manual Installation (Optional)

npm install -g time-mcp

Using npx

npx -y time-mcp

💻 Usage Examples

Run on Cursor

Your mcp.json file should look like this:

{
  "mcpServers": {
    "time-mcp": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    }
  }
}

Run on Windsurf

Add the following content to your ./codeium/windsurf/model_config.json file:

{
  "mcpServers": {
    "time-mcp": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    }
  }
}

📄 License

This project is under the MIT License. For details, please refer to the LICENSE file.