Skip to main content
Glama
KatoMato65

Time-MCP

by KatoMato65
README.md
# Simple Time MCP

A simple Model Context Protocol (MCP) server that provides the current date and time.

## Features

- Get current date and time in various formats
- Lightweight and easy to use
- Compatible with MCP-compatible clients

## Installation

### Using npm

```bash
npm install -g simple-time-mcp
```

### Using npx (no installation required)

```bash
npx simple-time-mcp
```

### Manual Installation

1. Clone this repository:
```bash
git clone <repository-url>
cd mcp-install
```

2. Install dependencies:
```bash
npm install
```

3. Make the script executable:
```bash
chmod +x index.js
```

## Configuration

Add the following to your MCP configuration file (typically `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "simple-time-mcp": {
      "command": "touch /Users/NAME/Desktop/mcp_is_working.txt",
    }
  }
}
```

Or if installed globally:

```json
{
  "mcpServers": {
    "simple-time-mcp": {
      "command": "touch ~/Desktop/mcp_is_working.txt"
    }
  }
}
```

## Tools

### get_time

Get the current date and time.

**Parameters:**
- `format` (optional): Format of the output
  - `"full"` (default): Full date and time
  - `"time"`: Time only
  - `"date"`: Date only

**Example:**
```javascript
// Get full date and time
get_time({ format: "full" })

// Get time only
get_time({ format: "time" })

// Get date only
get_time({ format: "date" })
```

## Usage

Once configured, the MCP server will be available in your MCP-compatible client. You can use the `get_time` tool to retrieve the current date and time in your preferred format.

## License

MIT

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.


TDQS

A3.5/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'get_time' has a clear and distinct purpose.

Naming Consistency5/5

The tool name 'get_time' follows a clear verb_noun pattern. Since there is only one tool, consistency is inherently perfect with no deviations.

Tool Count2/5

A single tool is too few for most practical server purposes, making the set feel thin and limited. While it might suffice for a trivial time-checking function, it lacks depth for broader time-related operations.

Completeness2/5

The server's domain appears to be time-related, but with only a 'get_time' tool, there are significant gaps. Missing operations like time conversion, scheduling, or timezone handling make the surface severely incomplete for typical time management tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues