Skip to main content
Glama
cooderamily

mcp-system-info

by cooderamily

System Info Tool

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)

Related MCP server: MCP System Info Server

๐Ÿš€ 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!

Available Tools

2 tools
get_hardware_infoGet Hardware InformationA

Get complete hardware information (CPU, memory, storage, graphics, battery, serial numbers)

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description should disclose behavioral traits like read-only nature or required permissions. It only states it gets information, without confirming it is non-destructive or safe.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single clear sentence with no unnecessary words, efficiently conveying the tool's purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description lists the key hardware components returned, providing useful context. However, it does not describe the return format or structure, leaving some ambiguity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, so the description naturally does not need to add parameter meaning. Baseline 4 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves complete hardware information, listing specific components (CPU, memory, storage, graphics, battery, serial numbers), distinguishing it from the sibling tool 'get_system_status' which focuses on system status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies this tool is for hardware specs, but it does not explicitly guide when to use it versus the sibling 'get_system_status' or mention any prerequisites or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_system_statusGet System StatusA

Get system status information (operating system, network interfaces, CPU and memory usage)

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It discloses what information is returned (OS, network, CPU, memory) but does not mention potential performance impact, authentication requirements, or data freshness. Basic transparency is achieved.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single, clear sentence that front-loads the purpose. No redundant or extra words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Description covers the tool's purpose but lacks details on return value structure or format. Since no output schema exists, more information would improve completeness. Still adequate for a simple getter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters and 100% schema coverage, so baseline is 4. Description adds no parameter information but none is needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves system status information and lists specific categories (OS, network, CPU, memory). This distinguishes it from the sibling tool 'get_hardware_info', which likely focuses on hardware details.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for obtaining system status but provides no explicit guidance on when to use this tool versus alternatives like 'get_hardware_info'. No when-not or context cues are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv0.3.0
    • First observedget_hardware_info
    • First observedget_system_status

TDQS

A3.9/5.0

Scored across 2 tools

Disambiguation5/5

Each tool targets a distinct aspect of system information: hardware details vs. dynamic system status. There is no overlap in purpose.

Naming Consistency5/5

Both tools follow a consistent 'get_<domain>' pattern, making the naming predictable and clear.

Tool Count3/5

With only 2 tools, the server feels minimal but not unreasonable for a focused purpose. However, the scope might benefit from a few more to cover software/process information.

Completeness3/5

The tools cover fundamental hardware and system status, but lack coverage of software inventory, running processes, or detailed storage analysis. The surface is functional but not comprehensive.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive system monitoring and diagnostics through 18 tools that provide detailed information about CPU, memory, disk usage, network interfaces, running processes, battery status, hardware details, and temperature monitoring. Allows users to query system information and performance metrics through natural language interactions.
    7 npm
    ISC
  • F
    license
    B
    quality
    D
    maintenance
    A lightweight MCP server that provides real-time hardware statistics including CPU, memory, disk, and NVIDIA GPU usage. It enables users to monitor system performance and retrieve comprehensive host machine specifications through a standardized interface.
    1
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with Linux system operations via MCP, including CPU, memory, processes, storage, filesystem, hardware, network, monitoring, and logs.
    9
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Hardware probe MCP server that provides deep hardware inventory and live sensor telemetry for AI agents, including CPU, memory, disk, GPU, and sensor data across platforms.
    6
    MIT