# Simple MCP

> Simple MCP is an open-source MCP server for developer tools. Minimal Python MCP test server exposing a random float tool for developers. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows, self-hosted
- **Repository:** https://github.com/oleksii-donets/simple_mcp
- **MCP Registry name:** io.github.oleksii-donets/simple_mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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.

## Alternatives

- [MCP Test](https://ai-powered.com/mcp/mcp-test-2): MCP Test is an open-source MCP server for developer tools.
- [Tiny Go MCP Server](https://ai-powered.com/mcp/tiny-go-mcp-server): Tiny Go MCP Server is an open-source MCP server for developer tools.
- [Makefile MCP](https://ai-powered.com/mcp/makefile-mcp-2): Makefile MCP is an open-source MCP server for developer tools.
- [python-sdk](https://ai-powered.com/mcp/python-sdk): python-sdk is an open-source MCP server for developer tools.
- [My MCP Server](https://ai-powered.com/mcp/my-mcp-server-10): My MCP Server is an MCP server for developer tools.
- [mcp-hub](https://ai-powered.com/mcp/mcp-hub): mcp-hub is an open-source MCP server for developer tools.
- [Crimson Crab MCP Template](https://ai-powered.com/mcp/crimson-crab-mcp-template): Crimson Crab MCP Template is an open-source MCP server for ai models and llm tooling.
- [GRACE Hello MCP](https://ai-powered.com/mcp/grace-hello-mcp): GRACE Hello MCP is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/simple-mcp
