Datetime MCP Server

🚀 DateTime MCP Server

A Model Completion Protocol (MCP) server that provides date-time and simple note management functions.

🚀 Quick Start

The DateTime MCP Server implements the MCP protocol and offers various date-time related tools and services. It can be used by any MCP client to access date-time information and manage simple notes.

✨ Features

Resources

The server provides the following resources:

• datetime://current - The current date and time.
• datetime://today - Today's date in ISO format.
• datetime://time - The current time in 24-hour format.
• note://internal/{name} - User-created notes.

Tools

The server offers the following tools:

• add-note - Add a new note with a name and content.
• get-current-time - Get the current time in various formats (ISO, readable, Unix timestamp, RFC3339).
• format-date - Format a date string according to a specified format pattern.

Prompts

The server provides the following prompts:

• summarize-notes - Create a summary of all notes.
• schedule-event - Assist in scheduling an event at a specific time.

📦 Installation

1. Clone the repository:

git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server

2. Create a virtual environment:

uv venv
source .venv/bin/activate

3. Install dependencies:

uv sync

💻 Usage Examples

Basic Usage

Run the Server

To run the server:

uv run python -m datetime_mcp_server.server

The server will start and listen for MCP protocol messages on stdin/stdout.

Connect to the Server

You can use any MCP client to connect to the server. For example, use the MCP CLI:

uv run mcp connect datetime-mcp-server

📚 Documentation

Development

Install Development Dependencies

# Install all dependencies including development dependencies
uv sync --dev

Run Tests

To run tests:

uv run pytest tests/

Unit Tests

Unit tests verify that each function of the server works correctly:

uv run pytest tests/acceptance/test_server.py

Integration Tests

Integration tests verify the interaction between different parts of the server:

uv run pytest tests/integration/test_integration.py

Use Makefile Tasks

Although the specific content of the Makefile is not provided in the documentation, it usually includes the following tasks:

• make install - Install dependencies.
• make test - Run tests.
• make lint - Format and check code style.
• make build - Build a release package.

📄 License

MIT

🤝 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Make modifications.
4. Run tests using uv run pytest.
5. Submit a pull request.