# Localhost MCP

***localhostmcp*** is an MCP server that allows LLMs to send HTTP requests to your local development server.

## Installation

You can try out *piston-mcp* locally without cloning it.

### Install [uv](https://github.com/astral-sh/uv)

To try out *piston-mcp* you'll need to install `uv`:

```bash
# On MacOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

### Install MCP Client

You will also need to download an MCP client to connect to *piston-mcp*, such as [Claude Desktop](https://claude.ai/download).

### Update MCP Client Configuration

Update the MCP client's configuration with the following configuration to connect to *piston-mcp*:

```json
{
  "mcpServers": {
    "localhostmcp": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "git+https://github.com/alvii147/localhostmcp.git@main",
        "localhostmcp"
      ]
    }
  }
}
```

## Usage

Once you've followed the steps above, your MCP client should be able to send requests to localhost for you:

![Claude Demo](docs/img/ClaudeDemo.png)

## Acknowledgements

* [Claude.ai](https://claude.ai/)