Back to Browse

Simple MCP Server

Developer ToolsModerate5.5MCP RegistryLocal
Free

Server data from the Official MCP Registry

A Test MCP server that provides tools, promts and resources

About

A Test MCP server that provides tools, promts and resources

Security Report

5.5
Moderate5.5Moderate Risk

This is a well-structured, minimal MCP server that provides basic developer tools functionality. The code is clean with proper environment variable handling and appropriate permissions for its purpose as a simple demo server with random number generation and utility functions. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 3 high severity).

3 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Transport typeOptional

Environment variable: APP_TRANSPORT

Server hostOptional

Environment variable: APP_HOST

Server portOptional

Environment variable: APP_PORT

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-oleksii-donets-simple-mcp": {
      "env": {
        "APP_HOST": "your-app-host-here",
        "APP_PORT": "your-app-port-here",
        "APP_TRANSPORT": "your-app-transport-here"
      },
      "args": [
        "simple-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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"
      ]
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!