PCPartPicker MCP Server

MCP server that enables AI hardware build agents to research PC components, assemble builds with compatibility checking, and export/share build configurations on PCPartPicker through web scraping.

Features

• Part search across 25 component categories with sorting and result capping
• Part details: full specifications and multi-merchant price comparison
• Compatibility checking: find parts compatible with your current selection
• Build management: add, remove, replace, clear, and save parts in a build list
• Build export: formatted exports for Reddit, HTML, text, BBCode, or PCPP markup
• Price trends: category-level pricing data over time
• Build guides: curated PCPartPicker build recommendations

Architecture

Two server profiles sharing a common codebase:

• Research Server (7 tools, read-only): search, details, compatibility, build view, export, trends, guides
• Build Server (7 tools): build mutations (add/remove/replace/clear/save) plus build view and export

Setup

Prerequisites

• Node.js 22+
• Optional: PCPartPicker cookies for build list session persistence (see Cookie Setup below)

Install & Build

npm install
npm run build

Configure MCP Client

Claude Desktop (Windows)

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "pcpartpicker-research": {
      "command": "node",
      "args": ["Q:/Claude/PCPartPicker-MCP/build/servers/research.js"]
    },
    "pcpartpicker-build": {
      "command": "node",
      "args": ["Q:/Claude/PCPartPicker-MCP/build/servers/build.js"]
    }
  }
}

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pcpartpicker-research": {
      "command": "node",
      "args": ["/path/to/PCPartPicker-MCP/build/servers/research.js"]
    },
    "pcpartpicker-build": {
      "command": "node",
      "args": ["/path/to/PCPartPicker-MCP/build/servers/build.js"]
    }
  }
}

Restart the Claude Desktop app to apply the changes.

Cookie Setup (Optional)

Cookies enable build list session persistence across server restarts. All research tools work without cookies. To set up cookies:

1. Export cookies from your browser using a cookie export extension (e.g., Cookie-Editor)
2. Save to pcppCookies.json in the project root
3. Format: Array of cookie objects (see pcppCookies.example.json)

Troubleshooting

The MCP server logs to stderr, which is captured by the MCP host. Check your host's log location for debugging:

• Claude Desktop (Windows): %APPDATA%\Claude\logs\
• Claude Desktop (macOS): ~/Library/Logs/Claude/

Development

See AGENTS.md for AI agent guidance or docs/ for detailed documentation.

License

The MIT license