simple-MCP

一个最小的 MCP (Model Context Protocol) server 示例,通过 stdio 暴露一个查询本机硬件信息的工具。

依赖

uv sync

uv run main.py

server 以 stdio 传输方式启动,等待 MCP 客户端连接。

无参数,返回结构化的主机信息:

字段	类型	说明
`system`	string	操作系统名称,如 Darwin / Linux / Windows
`release`	string	内核版本号
`machine`	string	CPU 架构,如 x86_64 / arm64
`processor`	string	处理器标识,部分平台可能为空
`memory_gb`	number	物理内存总量,单位 GB
`cpu_count`	integer	逻辑核心数,无法探测时为 -1
`cpu_model`	string	CPU 型号名称,无法探测时为 Unknown

返回类型是 pydantic model HostInfo,MCP 会据此生成自描述的 output schema,客户端无需解析字符串。

CPU 型号按平台探测:macOS 用 sysctl machdep.cpu.brand_string,Linux 读 /proc/cpuinfo,Windows 读 PROCESSOR_IDENTIFIER,全部失败时回退到 platform 模块。

{
  "mcpServers": {
    "hostInfoMcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/simple-MCP", "run", "main.py"]
    }
  }
}

uv run tools.py    # 直接打印主机信息 JSON