English Français العربية

io.github.oleksii-donets/simple_mcp

Official registry Other

A Test MCP server that provides tools, promts and resources

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package docker.io/d0nets/simple-mcp:0.0.4
Claude Code 
claude mcp add simple-mcp -e 'APP_TRANSPORT=STDIO' -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "simple-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/d0nets/simple-mcp:0.0.4"
            ],
            "env": {
                "APP_TRANSPORT": "STDIO"
            }
        }
    }
}

Environment variables

  • APP_TRANSPORT Transport type
OCI package docker.io/d0nets/simple-mcp:0.0.4
Claude Code 
claude mcp add simple-mcp -e 'APP_TRANSPORT=<APP_TRANSPORT>' -e 'APP_HOST=0.0.0.0' -e 'APP_PORT=8000' -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "simple-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/d0nets/simple-mcp:0.0.4"
            ],
            "env": {
                "APP_TRANSPORT": "<APP_TRANSPORT>",
                "APP_HOST": "0.0.0.0",
                "APP_PORT": "8000"
            }
        }
    }
}

Environment variables

  • APP_TRANSPORT required Transport type
  • APP_HOST Server host
  • APP_PORT Server port

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Run locally
  2. Server Environment Variables
  3. Docker
  4. Test as a standalone app
  5. Test as a docker image

# 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"
      ]
    }
  }
}

Frequently asked questions

What is io.github.oleksii-donets/simple_mcp?

A Test MCP server that provides tools, promts and resources

How do I install io.github.oleksii-donets/simple_mcp?

It runs on your machine. In Claude Code: claude mcp add simple-mcp -e 'APP_TRANSPORT=STDIO' -- docker run -i --rm docker.io/d0nets/simple-mcp:0.0.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.oleksii-donets/simple_mcp need an API key?

Yes. It expects APP_TRANSPORT, which you set in its configuration.

Is io.github.oleksii-donets/simple_mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.oleksii-donets/simple_mcp?

It is published by oleksii-donets. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.