Piston MCP Server

1<p align="center">
2    <img alt="Piston Logo" src="https://github.com/engineer-man/piston/blob/master/var/docs/images/piston.svg" width=125 />
3</p>
4 
5<h1 align="center">
6    Piston MCP Server
7</h1>
8 
9<p align="center">
10    <strong><i>piston-mcp</i></strong> is an MCP server that allows LLMs to connect to and execute code using <a href="https://github.com/engineer-man/piston"><i>Piston</i></a>.
11</p>
12 
13<div align="center">
14 
15[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/alvii147/piston-mcp/actions.yml?branch=main&label=GitHub%20Actions&logo=github)](https://github.com/alvii147/piston-mcp/actions) [![License](https://img.shields.io/github/license/alvii147/piston-mcp)](https://github.com/alvii147/piston-mcp/blob/main/LICENSE)
16 
17</div>
18 
19> [!WARNING]
20> As of Feb 15, 2026, [Piston API](https://github.com/engineer-man/piston) is no longer publicly available and requires an authorization token. This means *piston-mcp* will no longer work with the publicly hosted instance of Piston.
21 
22## Installation
23 
24You can try out *piston-mcp* locally without cloning it.
25 
26### Install [uv](https://github.com/astral-sh/uv)
27 
28To try out *piston-mcp* you'll need to install `uv`:
29 
30```bash
31# On MacOS and Linux
32curl -LsSf https://astral.sh/uv/install.sh | sh
33# On Windows
34powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
35```
36 
37### Install MCP Client
38 
39You will also need to download an MCP client to connect to *piston-mcp*, such as [Claude Desktop](https://claude.ai/download).
40 
41### Update MCP Client Configuration
42 
43Update the MCP client's configuration with the following configuration to connect to *piston-mcp*:
44 
45```json
46{
47  "mcpServers": {
48    "piston": {
49      "command": "uv",
50      "args": [
51        "tool",
52        "run",
53        "--from",
54        "git+https://github.com/alvii147/piston-mcp.git@main",
55        "piston_mcp"
56      ]
57    }
58  }
59}
60```
61 
62For Claude Desktop, the configuration file is usually found in:
63 
64```bash
65# On MacOS and Linux
66~/Library/Application\ Support/Claude/claude_desktop_config.json
67# On Windows
68%APPDATA%\Claude\claude_desktop_config.json
69```
70 
71## Usage
72 
73Once you've followed the steps above, your MCP client should be able to run code for you:
74 
75![Claude Demo](docs/img/ClaudeDemo.png)
76 
77## Acknowledgements
78 
79* [Piston](https://github.com/engineer-man/piston)
80* [Claude.ai](https://claude.ai/)
81