Simple MCP
Minimal Python MCP test server exposing a random float tool for developers
- 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.4Add to claude_desktop_config.json
{
"mcpServers": {
"simple_mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/d0nets/simple-mcp:0.0.4"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"simple_mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/d0nets/simple-mcp:0.0.4"
]
}
}
}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 typeAPP_TRANSPORTTransport typeRequiredAPP_HOSTServer hostAPP_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.
