alvii147/piston-mcp
🐍 ☁️ 🐧 🍎 🪟 - MCP server that lets LLMs execute code through the Piston remote code execution engine, with a zero-config uv setup and a ready-to-use Claude Desktop config example.
Quick Install
{
"mcpServers": {
"alvii147-piston-mcp": {
"command": "npx",
"args": [
"-y",
"alvii147-piston-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
Piston MCP Server
piston-mcp is an MCP server that allows LLMs to connect to and execute code using Piston.
[!WARNING] As of Feb 15, 2026, Piston API 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.
Installation
You can try out piston-mcp locally without cloning it.
Install uv
To try out piston-mcp you'll need to install uv:
# 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.
Update MCP Client Configuration
Update the MCP client's configuration with the following configuration to connect to piston-mcp:
{
"mcpServers": {
"piston": {
"command": "uv",
"args": [
"tool",
"run",
"--from",
"git+https://github.com/alvii147/piston-mcp.git@main",
"piston_mcp"
]
}
}
}
For Claude Desktop, the configuration file is usually found in:
# On MacOS and Linux
~/Library/Application\ Support/Claude/claude_desktop_config.json
# On Windows
%APPDATA%\Claude\claude_desktop_config.json
Usage
Once you've followed the steps above, your MCP client should be able to run code for you:
