Skip to content
MCP server

Simple MCP

Minimal Python MCP test server exposing a random float tool for developers

Install
Pricing
Open source
Platforms
CLI, API, Linux
Runs
Locally or Remotely
Version
1.0.1
Listing updated
today

Similar MCP servers

About Simple MCP

Simple MCP is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

The README says this is a deliberately small Model Context Protocol server written in Python, meant for testing MCP clients and setups rather than production work. Its one tool, random_float, returns a random float in the range from 0 up to but not including 1.

The server can run over stdio (the default), streamable HTTP, or SSE, selected through the APP_TRANSPORT environment variable. Host and port are configurable with APP_HOST and APP_PORT. The project can be launched directly with uv, run as a Docker image, or wired into Claude Desktop through a JSON config entry.

It suits developers who want a tiny, known-good MCP server to verify a client connection, test transport handling, or explore how tools, prompts and resources are declared.

Install

Run in a terminal

claude mcp add simple_mcp -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4

Add to claude_desktop_config.json

{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "simple_mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • APP_TRANSPORTTransport type
  • APP_TRANSPORTTransport typeRequired
  • APP_HOSTServer host
  • APP_PORTServer port

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

random_float
Returns a random float in the range [0, 1).

What it does

Random float tool
Exposes a single random_float tool that returns a value in the range [0, 1).
Multiple transports
Supports stdio, HTTP and SSE transports, chosen with an environment variable.
Configurable host and port
APP_HOST and APP_PORT set the bind address when running over HTTP.
Docker image
Published as a container image that can run in stdio or HTTP mode.
Claude Desktop setup
The README includes a config snippet for connecting it to Claude Desktop.

Good for

  • Verifying that an MCP client can connect and call a tool
  • Testing stdio, HTTP or SSE transport behaviour
  • Using as a minimal reference when building a new MCP server
  • Checking Docker-based MCP deployment before adding real tools

Pricing

Open source

Open-source project; no paid plan mentioned.

Simple MCP FAQ

Which transports does it support?

The README lists STDIO (default), HTTP and SSE, selected with the APP_TRANSPORT variable.

What tool does it provide?

A single tool named random_float that returns a random float between 0 and 1.

How do I run it in Docker?

Build the image with docker build, then run it with docker run, optionally setting APP_TRANSPORT and APP_PORT.

Is Simple MCP free?

Yes. Simple MCP is open source, so you can use and self-host it for free.

How do I add Simple MCP to Claude Code?

Run this command in your terminal: claude mcp add simple_mcp -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4

What are the best alternatives to Simple MCP?

The closest alternatives to Simple MCP are MCP Test, Tiny Go MCP Server, Makefile MCP, python-sdk and My MCP Server.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers