{
  "markdown": "# Simple MCP Server (Python)\r\n\r\nThis 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.\r\n\r\n## Run locally\r\n\r\n### Default (STDIO transport)\r\n```bash\r\nuv run main.py\r\n```\r\n\r\n## Server Environment Variables\r\n\r\n| Variable | Purpose | Default |\r\n|----------|---------|---------|\r\n| APP_TRANSPORT | Transport type (STDIO, HTTP, SSE) | STDIO |\r\n| APP_HOST | Server host | 0.0.0.0 |\r\n| APP_PORT | Server port | 8000 |\r\n\r\n## Docker\r\n\r\nBuild the image and run:\r\n\r\n```bash\r\ndocker build -t simple-mcp .\r\n```\r\n\r\n### Docker with different transports\r\n\r\n```bash\r\n# HTTP transport\r\ndocker run --rm -p 8000:8000 -e APP_TRANSPORT=HTTP simple-mcp\r\n\r\n# SSE transport\r\ndocker run --rm -p 8000:8000 -e APP_TRANSPORT=SSE simple-mcp\r\n\r\n# Custom port\r\ndocker run --rm -p 9000:9000 -e APP_TRANSPORT=HTTP -e APP_PORT=9000 simple-mcp\r\n```\r\n\r\n## Test as a standalone app\r\n### Test using Postman\r\n```\r\nuv --directory <path_to_project_directory> run main.py\r\n```\r\n\r\n### Test using Claude Desktop\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"simple_mcp\": {\r\n      \"command\": \"uv\",\r\n      \"args\": [\r\n        \"run\",\r\n        \"--directory\",\r\n        \"<path_to_project_directory>\",\r\n        \"main.py\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Test as a docker image\r\n### Test using Postman\r\n```\r\ndocker run --rm -i simple-mcp\r\n```\r\n\r\n### Test using Claude Desktop\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"simple_mcp\": {\r\n      \"command\": \"docker\",\r\n      \"args\": [\r\n        \"run\",\r\n        \"--rm\",\r\n        \"-i\",\r\n        \"simple-mcp\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```",
  "bytes": 1692,
  "sha": "6512336e5afe6e64eb9a2c665652d3dfa633791246e3b1f5edc70626ad069d72",
  "repo_slug": "oleksii-donets/simple_mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_oleksii_donets_simple_mcp_52f0d0be/readme"
}