ai-host-optimizer
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ai-host-optimizer
Profile a host, plan AI-model optimizations, and apply them — reversibly, with consent.
An MCP server and a CLI that inspects your machine, presents a checklist of AI-optimization options (each with an estimated improvement and its resource footprint), resolves a conflict-free plan, and — with explicit consent — applies the selected options by writing files into a managed config directory. Everything is dry-run by default and reversible.
Status: 1.0. The profiler and the planner are read-only. The applier writes only inside
~/.config/ai-host-optimizer(platform-appropriate), never touches system files, never runs a shell, and never escalates privilege.
Why
Running local models well depends on host configuration (KV-cache size, Flash Attention, prefix caching, memory/NUMA/swap behaviour, provider prompt caching). The knowledge is scattered across guides. This tool profiles your host and tells you what is worth doing — honestly, labelling each estimate by confidence.
Related MCP server: Local AI MCP
Install
# one-off
npx ai-host-optimizer --cli
# or globally
npm install -g ai-host-optimizerUsage
# report (read-only)
ai-host-optimizer --cli
ai-host-optimizer --cli --role container
# plan and apply
ai-host-optimizer --plan --select kv-cache-quant-q8,keep-alive-preload
ai-host-optimizer --apply --select kv-cache-quant-q8,keep-alive-preload # dry-run
ai-host-optimizer --apply --select kv-cache-quant-q8,keep-alive-preload --yes # apply
ai-host-optimizer --revert
# measure (tier A)
ai-host-optimizer --benchmark --save-baseline # before
ai-host-optimizer --benchmark # after (compares to baseline)
# generate declarative accessories from the same registry
ai-host-optimizer --generate ansible
ai-host-optimizer --generate dockerfile
ai-host-optimizer --generate checklist
# interfaces
ai-host-optimizer --mcp
ai-host-optimizer --browser # browser UI (not yet)
ai-host-optimizer --desktop # desktop UI (not yet)Applying writes only into the managed directory and prints the source line to
activate it. Undo any time with --revert.
Use as an MCP server
Add to your MCP client (e.g. Claude Desktop):
{
"mcpServers": {
"ai-host-optimizer": {
"command": "npx",
"args": ["-y", "ai-host-optimizer", "--mcp"]
}
}
}Tools exposed (M0):
Tool | Purpose |
| Read-only host profile (OS, CPU, memory, GPU, detected tooling) |
| Optimization options with estimated improvement + resource footprint |
| Registry consistency check (development aid) |
Honesty contract
Every estimate carries a confidence tier:
A — measured on your host (requires M1's benchmark).
B — labelled estimate with a cited method.
C — qualitative (direction only, no number).
Tier B/C estimates are never presented as measurements. A combined estimate is only shown once its inputs are trustworthy (see the project plan).
Safety
Read-only by default. Profiling and planning never change anything.
The applier writes only into the managed config directory (
~/.config/ai-host-optimizer, or the platform equivalent) — never system files — runs no shell, and escalates no privilege.Applying is dry-run first:
--applyshows the change;--yesperforms it.Everything applied is reversible with
--revert.Options are tagged with risk, reversibility and privilege needs.
Mutually exclusive options (e.g. KV-cache q8_0 vs q4_0; zram vs disk swap) are one-of groups; stackable options are marked stackable.
Role-aware: a
containercannot tune the host kernel; acluster-nodeis advisory-only.
Roadmap
M0 — read-only profiler, registry, checklist, CLI + MCP. ✅
M1 — reversible applier (user-space), plan/apply/revert, on-host benchmark. ✅
M1b — calibrated tier-B coefficient table. (planned)
M2 — accessory generation (Ansible/Dockerfile/checklist). ✅ (generation)
M2b — distribution to MCP registries. (planned)
M4 — browser UI and Tauri desktop UI. (planned)
Documentation
docs/architecture.md— one core, many front-ends; detection coverage; roadmap.docs/registry-schema.md— the option schema and the honesty contract.docs/publishing.md— releasing to npm and finishing the repo page.SECURITY.md— security policy and the read-only design commitments.
Contributing
Contributions are welcome — especially new optimization options and
corrections to unsupported claims. See CONTRIBUTING.md
for the dev setup and the registry contribution rules. Participation is governed
by CODE_OF_CONDUCT.md.
Licence
MIT. See LICENSE.
ai-host-optimizer
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
Related MCP Servers
- AlicenseAqualityBmaintenanceLocal-first production-readiness MCP server for AI-built apps. It runs read-only checks, produces an evidence-based readiness score, and guides fixes before launch.11224 npm7Apache 2.0

Local AI MCPofficial
AlicenseAqualityBmaintenanceUnified MCP server for managing local model runtimes (Ollama, LM Studio, etc.), enabling provider-agnostic discovery, lifecycle management, hardware-fit checks, and delegated inference.22104 npmCreative Commons Attribution Non Commercial No Derivatives 4.0 International- AlicenseAqualityDmaintenanceA secure, read-only MCP server for AI-powered system monitoring. It provides real-time OS metrics, config discovery, and safe log tailing to enable autonomous infrastructure audits without shell access risks.42ISC
- AlicenseAqualityDmaintenanceAn MCP server that gives AI assistants safe, read-only visibility into a host: CPU, memory, disk, processes, network, ports, and logs.8MIT