System Info

A system information tool based on the MCP (Model Context Protocol) specification

🎯 Features

This project implements the latest Model Context Protocol specification, providing:

• Hardware Information - Complete hardware details (CPU, memory, storage, graphics, battery, serial numbers)
• System Status - System status information (OS, network interfaces, CPU and memory usage)

🚀 Installation & Usage

Install Dependencies

# Using pnpm (recommended)
pnpm install

# Or using npm
npm install

Run MCP Server

# Start server
npm start

# Or development mode (auto-restart)
npm run dev

Global Installation (Optional)

npm link
# Then use directly
mcp-system-info

🔧 MCP Tools

The server provides 2 streamlined MCP tools:

Tool Name	Description	Parameters
get_hardware_info	Get complete hardware information	None
get_system_status	Get system status and resource usage	None

📝 Configuration

MacOS / Linux

{
  "mcpServers": {
    "system-info": {
      "command": "npx",
      "args": ["npx", "-y", "mcp-system-info"]
    }
  }
}

windows

{
  "mcpServers": {
    "system-info": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-system-info"]
    }
  }
}

🧪 Testing

Run the included test script:

node test.js

📊 Output Format

All tools return structured JSON data:

{
  "content": [
    {
      "type": "text", 
      "text": "# Information Title\n\n```json\n{data}\n```"
    }
  ]
}

🔒 Security

• Read-only system information access
• No system modification operations
• Structured JSON data format
• Follows MCP security best practices

📄 License

ISC

Welcome to submit Issues and Pull Requests to improve this tool!