Metadata-Version: 2.4
Name: umi-mcp
Version: 0.1.0
Summary: UMI MCP server — local system awareness for AI assistants
Project-URL: Homepage, https://spinchange.github.io/umi
Project-URL: Repository, https://github.com/spinchange/umi
Project-URL: Bug Tracker, https://github.com/spinchange/umi/issues
License: MIT
Keywords: agents,ai,llm,mcp,monitoring,system
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: psutil>=5.9.0
Description-Content-Type: text/markdown

# umi-mcp

A Python MCP server that gives AI assistants live awareness of the machine they're running on.

Install it, point your AI client at it, and ask questions like "what's using the most memory?" or "have there been any service crashes recently?" — and get real answers.

## Install

```bash
pip install umi-mcp
```

## Configure (Claude Desktop)

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "umi": {
      "command": "python",
      "args": ["-m", "umi_mcp"]
    }
  }
}
```

- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

Restart Claude Desktop. Check **Settings → Developer** to confirm UMI is connected.

## Tools

- `get_umi_uptime` — hostname, OS, arch, CPU%, memory utilization, swap, load averages
- `get_umi_disk` — volumes, capacity, usage, filesystem, I/O counters
- `get_umi_network` — interfaces, IPs, MAC, speed, bytes sent/received, errors
- `get_umi_process` — running processes by CPU, filterable by name or top N
- `get_umi_service` — Windows Services / systemd / launchd, with status
- `get_umi_user` — local accounts, groups, admin status
- `get_umi_events` — Windows Event Log / journald / macOS unified log, filterable by level

Works on Windows, Linux, and macOS.

## Full documentation

[github.com/spinchange/umi](https://github.com/spinchange/umi)
