mcpField
S
simple_mcp

simple_mcp

Local
github.com/oleksii-donetsDeveloper Tools0Updated 24w ago
Repository

About simple_mcp

simple_mcp is a minimal Python MCP server for testing and experimentation. It exposes one random-number tool and supports STDIO, HTTP, and SSE transports.

Key features

  1. 01Single random-float tool
  2. 02STDIO transport
  3. 03HTTP transport
  4. 04SSE transport
  5. 05Docker-based runs

Use cases

  1. 01Test an MCP client connection
  2. 02Experiment with transport modes
  3. 03Run a small server in Docker

MCP support

Exposes the `random_float` tool to MCP clients, returning a random value in [0,1). It supports STDIO, HTTP, and SSE transports.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "oleksii-donets-simple": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APP_TRANSPORT",
        "-e",
        "APP_HOST",
        "-e",
        "APP_PORT",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ],
      "env": {
        "APP_TRANSPORT": "<APP_TRANSPORT>",
        "APP_HOST": "<APP_HOST>",
        "APP_PORT": "<APP_PORT>"
      }
    }
  }
}
Run commanddocker run -i --rm -e APP_TRANSPORT -e APP_HOST -e APP_PORT docker.io/d0nets/simple-mcp:0.0.4
Environment variables to set
APP_TRANSPORTTransport type
APP_HOSTServer host
APP_PORTServer port

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocidocker.io/d0nets/simple-mcp:0.0.4

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Simple MCP Server (Python)

This project provides a minimal Model Context Protocol (MCP) server using Python. It exposes a single tool random_float that returns a random float in [0,1). The server supports multiple transport modes: STDIO (default), HTTP, and SSE.

Run locally

Default (STDIO transport)
uv run main.py

Server Environment Variables

VariablePurposeDefault
APP_TRANSPORTTransport type (STDIO, HTTP, SSE)STDIO
APP_HOSTServer host0.0.0.0
APP_PORTServer port8000

Docker

Build the image and run:

docker build -t simple-mcp .
Docker with different transports
# HTTP transport
docker run --rm -p 8000:8000 -e APP_TRANSPORT=HTTP simple-mcp

# SSE transport
docker run --rm -p 8000:8000 -e APP_TRANSPORT=SSE simple-mcp

# Custom port
docker run --rm -p 9000:9000 -e APP_TRANSPORT=HTTP -e APP_PORT=9000 simple-mcp

Test as a standalone app

Test using Postman
uv --directory <path_to_project_directory> run main.py
Test using Claude Desktop
{
  "mcpServers": {
    "simple_mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<path_to_project_directory>",
        "main.py"
      ]
    }
  }
}

Test as a docker image

Test using Postman
docker run --rm -i simple-mcp
Test using Claude Desktop
{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "simple-mcp"
      ]
    }
  }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.