README.md•1.58 kB
# 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.