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:

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows (PowerShell):

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.

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.

{
  "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.