system-info-mcp 0.0.2

MCP server provide system information tools

System Info MCP Server

A Model Context Protocol (MCP) server that provides system information tools.

Features

• Cross-platform support (Windows, macOS, Linux)
• Basic system information: OS, architecture, shell
• FastMCP-based implementation
• Comprehensive error handling

Installation

uv sync

Usage

Run with stdio (default)

uv run python -m system_info_mcp.server

Run with HTTP transport

uv run python -m system_info_mcp.server --transport http --port 8000

Or modify server.py:

if __name__ == "__main__":
    mcp.run(transport="http", port=8000)

MCP Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

```json (stdio) { "mcpServers": { "system-info": { "command": "uv", "args": ["run", "python", "-m", "system_info_mcp.server"] } } } ```

{
  "mcpServers": {
    "system-info": {
      "url": "http://localhost:8000/mcp",
      "transport": "http"
    }
  }
}

VS Code (MCP Extension)

Add to .vscode/mcp.json:

{
  "servers": [
    {
      "name": "system-info",
      "command": "uv",
      "args": ["run", "python", "-m", "system_info_mcp.server"],
      "transport": "stdio"
    }
  ]
}

Programmatic Client

import asyncio
from fastmcp import Client

async def main():
    # Connect via HTTP
    async with Client("http://localhost:8000/mcp") as client:
        result = await client.call_tool("get_system_info", {})
        print(result)

    # Or connect via stdio
    async with Client("python -m system_info_mcp.server") as client:
        result = await client.call_tool("get_system_info", {})
        print(result)

asyncio.run(main())

Supported Transports

Transport	Description	Use Case
stdio	Standard input/output	Local development, Claude Desktop, VS Code
HTTP	HTTP server with SSE	Remote servers, web deployments
SSE	Server-Sent Events	Streaming responses, real-time updates

Development

# Install dependencies
uv sync

# Run tests
pytest tests/ -v

# Format code
ruff format src/ tests/

Tool Specification

Tool Name: get_system_info

Description: 获取系统基本信息并返回JSON

Response Format:

{
  "os": "Darwin",
  "os_version": "Darwin Kernel Version 23.4.0",
  "os_release": "23.4.0",
  "architecture": "arm64",
  "processor": "arm",
  "shell": "/bin/zsh"
}