A multi-language Model Context Protocol (MCP) server project that provides system utility tools. This repository features multiple variants implemented in Rust and Python, supporting both Streaming HTTP (SSE) and Stdio transports. It is optimized for both local development and deployment on Google Cloud Run with Identity-Aware Proxy (IAP) or API Key security.
This repository is organized into several variants to suit different deployment and development needs:
iap/: Standard version for Google Cloud Run with IAP. Decodesx-goog-iap-jwt-assertion.manual/: Enhanced version for Cloud Run with API key check (ADC-fetched) and IAP.local/: Tailored for local development over HTTP withgcloudAPI key fetching.stdio/: Lightweight Stdio-based version for local use without extra security layers.stdiokey/: Stdio-based version with API key validation (fetched viagcloudor ADC).
local-python/: Python implementation of the local HTTP (SSE) variant with API key security.manual-python/: Python implementation optimized for Cloud Run/Manual use (SSE) with API key security.stdiokey-python/: Python implementation using Stdio transport with API key validation.
| Variant | Language | Transport | Security | Key Fetching |
|---|---|---|---|---|
iap |
Rust | HTTP | IAP | N/A |
manual |
Rust | HTTP | IAP + API Key | ADC |
local |
Rust | HTTP | API Key | gcloud |
stdio |
Rust | Stdio | None | N/A |
stdiokey |
Rust | Stdio | API Key | gcloud / ADC |
local-python |
Python | HTTP (SSE) | API Key | gcloud / ADC |
manual-python |
Python | HTTP (SSE) | API Key | gcloud / ADC |
stdiokey-python |
Python | Stdio | API Key | gcloud / ADC |
- System Information: Detailed host report (CPU, Memory, OS, Network).
- Disk Usage: Reports usage for all mounted partitions.
- Process List: Lists top 20 processes by memory (available in
manualvariants).
- Rust: Toolchain (Edition 2024)
- Python: Version 3.11+
- Make: For automated tasks
cd manual
make build
# Ensure ADC is configured or set MCP_API_KEY env var
make runcd local-python
make install
make run KEY=<YOUR_API_KEY>Most variants support direct CLI execution for quick reports:
- Rust:
cargo run -- infoorcargo run -- disk - Python:
python3 main.py infoorpython3 main.py disk
Each subdirectory contains its own Makefile for formatting (make fmt), linting (make clippy / make lint), and testing (make test). Deployment to Cloud Run is supported for iap/ and manual/ variants via make deploy.