Formulahendry MCP Server Code Runner

Code Runner MCP Server is an MCP service that supports running code snippets in multiple programming languages. It can be installed and deployed via npm, Docker, or Smithery.

Developer tools Education and learning tools #Code running #Multi - language #MCP service #Development tool Local .TypeScript

rating : 2 points

downloads : 6.1K

update time : 2025-04-28

Open Site

What is Code Runner MCP Server?

Code Runner is an MCP protocol server that allows you to directly run code snippets in multiple programming languages in a conversation environment. It's like having a built - in code execution environment in the chat window, enabling you to instantly get the code execution results.

How to use Code Runner?

Tell the AI the code you want to run through simple natural language instructions. The AI will send the code to the Code Runner server for execution via the MCP protocol and then return the results to you.

Applicable scenarios

Scenarios such as quickly testing code snippets, querying system information, learning programming languages, and debugging simple code. It is especially suitable for programming learning and debugging processes that require instant feedback.

Main features

Multi - language support

Supports more than 30 programming languages, including mainstream languages such as JavaScript, Python, PHP, Ruby, and Go.

Easy integration

Provides multiple integration methods: direct run with npx, Docker container, or hosting through the Smithery platform.

Cross - platform

Can run on Windows, macOS, and Linux systems.

Advantages

Execute code instantly and get results without switching the development environment

Support a wide range of programming languages

Simple configuration with multiple deployment options

Open - source project, can be modified and extended by yourself

Limitations

Need to pre - install the interpreter/compiler for the corresponding language

Not suitable for running complex or long - running programs

There may be connection issues with npx on Windows systems

How to use

Select the installation method

Choose the installation method of npx, Docker, or Smithery hosting according to your needs.

Configure the client

Add server settings to the configuration file of VS Code or Claude Desktop.

Start using

Enter instructions or questions containing code in the chat window.

Usage examples

Simple mathematical calculation

Execute JavaScript code for mathematical calculations

System information query

Query the location of the operating system's temporary folder

Hardware information query

Query the number of CPU cores

Frequently Asked Questions

Why can't my code be executed?

What should I do if the npx connection fails on Windows?

How to add support for a new language?

Is there a security risk when executing code?

Related resources

GitHub repository

Project source code and issue tracking

npm package page

npm package information and download statistics

Docker image

Official Docker image

Smithery platform

Hosting service installation page

MCP server generator

Tool for creating custom MCP servers

🚀 Code Runner MCP Server

A MCP server for running code snippets and displaying results.

This server supports a wide range of programming languages, including JavaScript, PHP, Python, Perl, Perl 6, Ruby, Go, Lua, Groovy, PowerShell, BAT/CMD, BASH/SH, F# Script, C# Script, VBScript, TypeScript, CoffeeScript, Scala, Swift, Julia, Crystal, OCaml Script, R, AppleScript, Elixir, Clojure, Racket, Scheme, AutoHotkey, AutoIt, Kotlin Script, Dart, Haskell, Ni, Lisp, Kit, V, SCSS, Sass. For the full list, please refer to constants.ts.

📦 Installation and Configuration

Using npx in VS Code

Configure in settings.json:

{
  "mcp": {
    "inputs": [],
    "servers": {
      "mcp-server-code-runner": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-server-code-runner"
        ]
      }
    }
  }
}

Using npx in Claude Desktop

Configure in claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-code-runner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-code-runner"
      ]
    }
  }
}

Using Docker

Taking VS Code as an example, configure in settings.json:

{
  "mcp": {
    "inputs": [],
    "servers": {
      "mcp-server-code-runner": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "formulahendry/mcp-server-code-runner"
        ]
      }
    }
  }
}

Installation via Smithery

⚠️ Important Note

This will host the Code Runner MCP Server using the remote container environment of Smithery.

To automatically install the Code Runner MCP Server for Claude Desktop:

npx -y @smithery/cli install @formulahendry/mcp-server-code-runner --client claude

🛠️ Solving npx Issues on Windows

If you encounter npx-related issues on Windows, follow these steps:

Open the Command Prompt (CMD).
Run the following command to install the required dependencies:
```
npm install -g npm.cmd
```
After the installation is complete, restart the Command Prompt.
Ensure that Node.js and npm are correctly installed and verify their versions:
```
node --version
npm --version
```
If the issue persists, check if the environment variable configuration is correct.

💻 Usage Instructions

When using the MCP server for code execution, you can operate it with the following command:

npm start

After running, the server will listen for requests on the specified port and process incoming code execution tasks. Make sure that the firewall and security software allow communication on this port.

🤝 Contributing to the Project

If you want to contribute to this project, please visit its GitHub repository: mcp-server-code-runner and follow the contribution guidelines.

📄 License

This project is licensed under the MIT License.

By following the above steps, you can successfully install, configure, and use the Code Runner MCP Server to run and manage code snippets in multiple programming languages.