# mcp-week-day

A small [MCP](https://modelcontextprotocol.io) server built with [FastMCP](https://github.com/jlowin/fastmcp). It exposes a single tool, `day_in_week`, which returns the current day of the week — `"Monday"`, `"Tuesday"`, …

## Requirements

- Python 3.10+

## Setup & run from scratch

### Using `uv` (recommended)

```bash
# Run the server
uv run mcp-week-day
```

First run might take some time as a virtual environment will be created and dependencies will be installed into it.

### Using `pip`

```bash
# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate        # on Windows: .venv\Scripts\activate

# Install the project (+ dependencies)
pip install -e .

# Run the server
mcp-week-day
```

The server communicates over stdio using the MCP protocol.

### Register with an MCP client

Add an entry like this to your client's MCP configuration:

```json
{
  "mcpServers": {
    "week-day": {
      "command": "uv",
      "args": ["run", "mcp-week-day"]
    }
  }
}
```

If you installed with `pip` into an activated environment, you can instead use
`"command": "mcp-week-day"` with no args.

## Tool

| Tool          | Arguments | Returns                                          |
| ------------- | --------- | ------------------------------------------------ |
| `day_in_week` | none      | The current weekday name, e.g. `"Monday"`.       |