Metadata-Version: 2.4
Name: system-info-mcp-server
Version: 1.0.0
Summary: System Information MCP Server for Claude Desktop - Get real-time system information
Project-URL: Documentation, https://github.com/username/system-info-mcp-server#readme
Project-URL: Issues, https://github.com/username/system-info-mcp-server/issues
Project-URL: Source, https://github.com/username/system-info-mcp-server
Author-email: Your Name <your.email@example.com>
License-Expression: MIT
Keywords: claude,desktop,mcp,model-context-protocol,system-info
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.8
Requires-Dist: mcp>=1.0.0
Requires-Dist: psutil>=5.9.0
Description-Content-Type: text/markdown

# System Info MCP Server

[![npm version](https://badge.fury.io/js/%40system-info%2Fmcp-server.svg)](https://badge.fury.io/js/%40system-info%2Fmcp-server)
[![PyPI version](https://badge.fury.io/py/system-info-mcp-server.svg)](https://badge.fury.io/py/system-info-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A Model Context Protocol (MCP) server that provides real-time system information for Claude Desktop. Available in both **Node.js** and **Python** with identical functionality.

## 🚀 Quick Start

Choose your preferred implementation:

### Option 1: Node.js with npx (Recommended)

```bash
# Test instantly
npx @system-info/mcp-server@latest --test
```

### Option 2: Python with pipx

```bash
# Test instantly  
pipx run system-info-mcp-server --test
```

Both work identically! Choose based on your preference.

## 🔧 Claude Desktop Configuration

### Node.js Implementation
```json
{
  "mcpServers": {
    "system-info": {
      "command": "npx",
      "args": ["@system-info/mcp-server@latest"]
    }
  }
}
```

### Python Implementation
```json
{
  "mcpServers": {
    "system-info": {
      "command": "pipx",
      "args": ["run", "system-info-mcp-server"]
    }
  }
}
```

### Config file locations:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux**: `~/.config/Claude/claude_desktop_config.json`

## ✨ Features (Both Implementations)

- **📊 CPU Information**: Usage, cores, frequency, temperature
- **💾 Memory Status**: RAM usage, swap, availability  
- **💿 Disk Usage**: Storage space across all drives
- **🔄 Process Management**: Running processes with sorting
- **🖥️ System Overview**: OS details, uptime, hardware
- **🌐 Network Information**: Interfaces, connections
- **⚡ Quick Stats**: Instant system health overview

## 🎯 Which Should You Choose?

### Choose **Node.js** if:
- ✅ You want the fastest performance
- ✅ You prefer JavaScript/TypeScript
- ✅ You want minimal memory usage
- ✅ You work with npm ecosystem

### Choose **Python** if:
- ✅ You prefer Python
- ✅ You work with PyPI ecosystem  
- ✅ You want to extend with Python libraries
- ✅ You're comfortable with Python tooling

Both implementations are **functionally identical** and maintained in parallel.

## 📋 Usage Examples

Ask Claude any of these questions:

```
"What's my system status?"
"Show me CPU and memory usage"  
"What processes are using the most resources?"
"How much disk space is available?"
"What are my computer's specs?"
"List all network interfaces"
```

## 🔧 Requirements

### Node.js Implementation
- **Node.js**: 18.0.0+
- **npx**: Included with npm

### Python Implementation  
- **Python**: 3.8+
- **pipx**: `pip install pipx`

### Both Need
- **Claude Desktop**: 0.7.0+ (for MCP support)

## 🤝 Contributing

Contributions welcome for both implementations! Please:

1. Fork the repository
2. Choose your implementation (Node.js or Python)
3. Make changes in the appropriate directory
4. Ensure both implementations stay in sync
5. Add tests and update documentation
6. Submit a pull request

## 📄 License

MIT License - see [LICENSE](LICENSE) file.

---

**Made with ❤️ for the Claude Desktop community**