simple-MCP

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

依赖

• Python >= 3.13

• uv

Related MCP server: mcpscope

安装

uv sync

运行

uv run main.py

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

工具

get_host_info

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

返回类型是 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