simple_mcp

Name: simple_mcp
Author: oleksii-donets

本地服务

github.com/oleksii-donets开发工具024 周前更新

代码仓库

关于 simple_mcp

simple_mcp 是用于测试和实验的精简 Python MCP 服务，提供一个随机数工具，并支持 STDIO、HTTP 和 SSE 传输方式。

主要功能

01单一随机浮点数工具
02STDIO 传输
03HTTP 传输
04SSE 传输
05通过 Docker 运行

适用场景

01测试 MCP 客户端连接
02试验不同传输方式
03在 Docker 中运行轻量服务

MCP 相关

向 MCP 客户端提供 `random_float` 工具，返回 [0,1) 范围内的随机值，并支持 STDIO、HTTP 和 SSE 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "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>"
      }
    }
  }
}

启动命令docker run -i --rm -e APP_TRANSPORT -e APP_HOST -e APP_PORT docker.io/d0nets/simple-mcp:0.0.4

需要配置的环境变量

APP_TRANSPORTTransport type

APP_HOSTServer host

APP_PORTServer port

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocidocker.io/d0nets/simple-mcp:0.0.4stdioStreamable HTTP

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Simple MCP Server（Python）

此项目使用 Python 提供一个精简的 Model Context Protocol（MCP）服务。它提供单个工具 random_float，用于返回一个范围在 [0,1) 内的随机浮点数。服务支持多种传输模式：STDIO（默认）、HTTP 和 SSE。

在本地运行

默认（STDIO 传输）

uv run main.py

服务环境变量

变量	用途	默认值
APP_TRANSPORT	传输类型（STDIO、HTTP、SSE）	STDIO
APP_HOST	服务主机	0.0.0.0
APP_PORT	服务端口	8000

Docker

构建镜像并运行：

docker build -t simple-mcp .

使用不同传输方式运行 Docker

# 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

作为独立应用测试

使用 Postman 测试

uv --directory <path_to_project_directory> run main.py

使用 Claude Desktop 测试

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

作为 Docker 镜像测试

使用 Postman 测试

docker run --rm -i simple-mcp

使用 Claude Desktop 测试

{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "simple-mcp"
      ]
    }
  }
}

支持 Markdown

登录后评论