MCP服务器

一个基于Python的最小化Model Context Protocol (MCP)服务器,提供随机浮点数生成功能,支持STDIO、HTTP和SSE多种传输模式。

  • by oleksii-donets
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 oleksii-donets/simple_mcp

使用说明

简单的MCP服务器(Python版)

这个项目提供了一个使用Python实现的最小模型上下文协议(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桌面版进行测试

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

作为 Docker 镜像进行测试

使用Postman进行测试

docker run --rm -i simple-mcp

使用Claude桌面版进行测试

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