# MCP Server Example

This project is an example of a simple web server, `mcp-server`, designed to be run easily and without a complex setup process.

It uses `uv`, a fast Python package manager, to execute the server directly from its GitHub repository in a temporary environment.

## Prerequisites

Before you can run the server, you need to have **`uv`** installed on your system.

### Install `uv`

**On macOS and Linux:**
```shell
curl -LsSf https://astral.sh/uv/install.sh | sh
```

**On Windows (PowerShell):**
```shell
irm https://astral.sh/uv/install.ps1 | iex
```

## Running the Server

You can run the server with a single command in your terminal. This command uses `uvx` to fetch the code from GitHub, set up a temporary environment, and run the `mcp-server` application.

```shell
uvx --from git+https://github.com/sakthigcp/mcpserverexample.git mcp-server
```

After running this, the server will start and be accessible on your local machine (typically at `http://127.0.0.1:8000`).

## Task Runner Configuration

The JSON snippet below is an example of how you might configure a task runner (like `just` or a custom script) to create a convenient alias for the run command.

In this configuration, a task named `addnumbers` is defined to execute the server.

```json
{
  "addnumbers": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/sakthigcp/mcpserverexample.git",
      "mcp-server"
    ]
  }
}
```

If you were using a tool that reads this configuration, you could simply run `your-task-runner addnumbers` to start the server.