Date and Time MCP Server

A simple Model Context Protocol (MCP) server that provides date and time functionality, along with example user profile and greeting resources.

Features

Get current date and time in any timezone
Access user profiles by ID
Get personalized greetings

Installation

Clone this repository
Install dependencies:

pip install -r requirements.txt

Usage

Running the Server

Start the server with:

python src/server.py

The server will start on http://127.0.0.1:8001 with the following endpoints:

Tools:
- current_datetime(timezone: str): Get current date and time in a specific timezone
Resources:
- users://{user_id}/profile: Get a user's profile by ID
- greeting://{name}: Get a personalized greeting

Running the Client

Run the example client with:

python src/client.py

The client will:

List all available tools
List all available resources
Call the current_datetime tool with "America/New_York" timezone

Running the LangChain Client Example

This project includes an example of using the MCP server with LangChain, based on the langchain-mcp-adapters repository.

To run the LangChain client example:

First, make sure the MCP server is running:

python src/server.py

Set your OpenAI API key as an environment variable:

# On Windows
set OPENAI_API_KEY=your-api-key-here

# On Unix/Linux/MacOS
export OPENAI_API_KEY=your-api-key-here

Run the LangChain client:

python src/langchain_client.py

The LangChain client demonstrates how to integrate the MCP server with LangChain's agent system, allowing for more complex interactions and reasoning about the available tools.

Cursor Configuration

To use this server with Cursor IDE, you need to configure it in your Cursor settings. Create or update the mcp.json file in your Cursor configuration directory with the following:

{
  "mcpServers": {
    "my-mcp-local-server": {
      "command": "path/to/your/python.exe",
      "args": [
        "path/to/your/server.py"
      ],
      "description": "MCP local server"
    },
    "my-mcp-remote-server": {
      "url": "http://127.0.0.1:8001/mcp",
      "description": "MCP remote server"
    }
  }
}

This configuration provides two ways to connect to the server:

my-mcp-local-server: Runs the server locally through Python
my-mcp-remote-server: Connects to the server running on port 8001

Make sure to replace the paths with your actual Python and server script paths.

Example API Usage

Get Current Time

result = await client.call_tool("current_datetime", {"timezone": "America/New_York"})

Get User Profile

profile = await client.read_resource("users://123/profile")

Get Greeting

greeting = await client.read_resource("greeting://John")

Development

The server is built using FastMCP, which provides a simple way to create MCP-compatible servers. The main components are:

server.py: Contains the server implementation with tools and resources
client.py: Example client that demonstrates how to interact with the server

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A simple Model Context Protocol (MCP) server that provides date and time functionality in any timezone, along with user profiles and personalized greeting resources.

Related MCP Servers

MCP Server
la-rebelion
-
security
A
license
-
quality
MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
4
3
TypeScript
MIT License
Time Server
clssck
-
security
F
license
-
quality
An MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.
Last updated -
Python
MCP DateTime
odgrim
A
security
A
license
A
quality
A TypeScript server implementing the Model Context Protocol (MCP) that provides datetime and timezone information to AI agents and chat interfaces, allowing them to access current time in various timezones.
Last updated -
4
2
TypeScript
Mozilla Public License 2.0
Time MCP
samay58
-
security
F
license
-
quality
A Claude Model Configuration Protocol (MCP) server that provides real-time timezone-aware date and time information.
Last updated -
Python

View all related MCP servers

Date and Time MCP Server