# System Information MCP Server
An MCP server that provides various tools and resources to monitor and retrieve host system information.
## Features
### Tools
- `get_system_info`: Basic information about the host system (OS, memory, uptime, etc.).
- `get_current_time`: Current localized time on the host system.
- `get_disk_usage`: Disk space information (Windows-optimized using WMIC).
- `get_cpu_load`: CPU load averages and model information.
- `get_network_interfaces`: Details about all network interfaces.
- `list_directory`: List contents of a directory with file sizes and dates.
- `move_files`: Move or rename files/directories safely.
- `search_files`: Search for files in a directory matching a pattern.
- `delete_files`: Delete files or directories permanently (with safety guards).
- `find_large_files`: Identify heavy files for system cleaning.
### 🛡️ Safety Guards
- The server includes logic to block operations on critical system directories (e.g., `C:\Windows`, `C:\Program Files`) and drive roots.
### Resources
- `system://os_info`: Static OS details (platform, release, hostname).
### Prompts
- `system_health_check`: A prompt to guide an AI agent through a comprehensive system health analysis.
## Installation
```bash
npm install
npm run build
```
## Usage
### Option 1: Claude Desktop (Stdio)
Add the following to your Claude Desktop configuration:
```json
{
"mcpServers": {
"sysinfo": {
"command": "node",
"args": ["C:/Users/marko/.gemini/antigravity/scratch/mcp-server/build/index.js"]
}
}
}
```
### Option 2: Web Mode (SSE) - "Un-containerized"
If you are having permission issues with Claude Desktop, you can run the MCP server as a standalone web server:
1. Run the server:
```bash
node build/index.js --sse
```
2. The server will be available at `http://localhost:3000/sse`.
3. You can connect to this URL using any MCP-compatible web client or custom integration.
## Development
- `npm run watch`: Rebuild on changes.
- `npm test`: Run unit tests (Vitest).
