parts-finder-mcp

command module
v0.1.12 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 14, 2026 License: MIT Imports: 51 Imported by: 0

README

parts-finder-mcp

A local MCP server that turns Claude into a server-hardware sourcing assistant. Describe the machine you want; Claude searches the live web for compatible parts, checks them against each other, finds real listings with current prices in your currency, and builds a costed spec you can export to a spreadsheet.

It runs entirely on your machine and speaks over stdio — no accounts, no API keys, no ports.

Install

Homebrew (macOS + Linux):

brew install stubbedev/parts-finder/parts-finder

Nix:

nix profile install github:stubbedev/parts-finder-mcp

Docker (multi-arch, runs natively on Apple Silicon):

docker pull ghcr.io/stubbedev/parts-finder-mcp:latest

Register with Claude Code

Native binary:

claude mcp add parts-finder -- /abs/path/to/parts-finder

Docker — the named volumes keep your saved parts and specs across sessions:

claude mcp add parts-finder -- docker run -i --rm \
  -v parts-finder-data:/data \
  -v parts-finder-cache:/root/.cache \
  ghcr.io/stubbedev/parts-finder-mcp:latest

Register with Claude Desktop

Open Settings → Developer → Edit Config (this opens claude_desktop_config.json), add parts-finder under mcpServers, then restart Claude Desktop.

Native binary:

{
  "mcpServers": {
    "parts-finder": {
      "command": "/abs/path/to/parts-finder"
    }
  }
}

Docker:

{
  "mcpServers": {
    "parts-finder": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "parts-finder-data:/data",
        "-v", "parts-finder-cache:/root/.cache",
        "ghcr.io/stubbedev/parts-finder-mcp:latest"
      ]
    }
  }
}

What you can ask

Once registered, just talk to Claude in plain language:

  • Spec a build — "Spec a 24-bay TrueNAS box around an Epyc 7003, 256 GB RAM, budget 15k DKK." Claude finds parts, verifies they fit together (socket, memory type, slots, power, clearance), and flags anything missing.
  • Price it — every listing is checked live and priced in your local currency, VAT-aware, so business and consumer prices compare fairly. Dead or out-of-stock listings are flagged, never silently dropped.
  • Shop it — get the best buy link per part plus alternatives, grouped by vendor so you can consolidate shipping.
  • Compare options — build a few candidate specs and compare them side-by-side on compatibility, power draw, and total cost (including indicative yearly power cost).
  • Track prices — record prices over time to judge "buy now or wait", and find cheaper drop-in substitutes within a budget.
  • Export — get a polished .xlsx with a sheet per spec and a compare sheet.

Region and currency are detected automatically from your IP and search is biased toward local and EU vendors. The live web is always the source of truth — Claude searches rather than guessing from training data.

Already own some parts? Tell Claude — owned units count toward compatibility and power but are excluded from the purchase total, so a piecemeal upgrade prices only what you're missing.

Development

just build        # ./bin/parts-finder
go test ./...

Compatibility rules, the retrieval pipeline, resource accounting, and configuration env vars are documented in CONTRIBUTING.md.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL