Skip to main content
Glama
VikasPrajapati1998

DateTime-LocalMCPServer

README.md
# MCP Server Setup Guide

A step-by-step guide to set up and run a Model Context Protocol (MCP) server using FastMCP.

## Installation Steps

- UV is a fast Python package manager. Install it using pip:
```bash
pip install uv
```
- Verify installation:
```bash
uv --version
```
- Create a new directory for your MCP server and initialize it:
```bash
mkdir mcp-server
cd mcp-server
uv init .
```
- This creates the necessary project structure with:
    - `pyproject.toml` - Project configuration
    - `.python-version` - Python version specification
    - `README.md` - Project documentation
- Add FastMCP to your project dependencies:
```bash
uv add fastmcp
```
- Create a file named `main.py` with your server code:
- Use the `MCP Inspector` to test your server interactively:
```bash
uv run fastmcp dev main.py
```
- To run your server normally:
```bash
uv run fastmcp run main.py
```
- Automatically configure Claude Desktop to use your MCP server:

```bash
uv run fastmcp install claude-desktop main.py
```

## License

This project is licensed under the MIT License.

TDQS

A4.2/5.0

Scored across 9 tools

Disambiguation4/5

Most tools have distinct purposes focused on specific date/time components, though current_datetime and formatted_datetime could potentially overlap if the default format matches ISO 8601. The descriptions help clarify differences, with current_datetime providing a fixed ISO format while formatted_datetime allows customization.

Naming Consistency5/5

All tool names follow a consistent snake_case pattern with clear 'current_' or descriptive prefixes (formatted_datetime, timezone_datetime, unix_timestamp). The naming convention is predictable and readable throughout the entire set.

Tool Count4/5

Nine tools is reasonable for a datetime server, though it feels slightly heavy with separate tools for day, month, and year that could potentially be combined. The count supports comprehensive datetime operations without being overwhelming.

Completeness5/5

The toolset provides complete coverage for datetime operations including current date/time retrieval, formatting, timezone handling, and Unix timestamp conversion. No obvious gaps exist for a server focused on current datetime information retrieval.

Maintenance

ActivityInactive
ResponsivenessNo issues