mcp-meupc

The mcp-meupc MCP server provides tools to search Brazilian PC components, compare prices across stores, discover current deals, and explore community builds on meupc.net without requiring API keys. Once you have the server running, you can instruct your MCP client to connect to the meupc server and use its available tools to locate components, fetch full specs and prices, and browse budget-friendly or high-performance configurations. The included tools allow searching by text, listing components by category with pagination, retrieving detailed component data across stores, and pulling current deals as well as 90-day price history. Community builds can be explored and detailed for quick inspiration or validation of compatibility when assembling a PC.

To use it, configure your MCP client to point at the meupc server as shown in the Quick Start configuration. Then call tools such as search_components, list_components, get_component_details, get_deals, list_community_builds, and get_build_details to perform your queries. The server handles parsing product pages, aggregating prices from multiple stores, and returning structured results suitable for AI-assisted decision making.

Prerequisites:

• Node.js (LTS version) installed on your system
• Git (optional, for cloning the repository)

Install from npm registry (recommended):

1. Install the MCP server package:

npm install -g mcp-meupc

2. Start the server directly (the MCP client will connect via npx as configured):

npx -y mcp-meupc

Build from source (optional):

1. Clone the repository:

git clone https://github.com/leosebben/mcp-meupc.git
cd mcp-meupc

2. Install dependencies and build:

npm install
npm run build

3. Run the built server (path may vary based on build output):

node build/index.js

Configuration example (as used in MCP clients):

{
  "mcpServers": {
    "meupc": {
      "command": "npx",
      "args": ["-y", "mcp-meupc"]
    }
  }
}

Tips and caveats:

• No API keys are required to use mcp-meupc; it fetches data directly from public sources like meupc.net and store pages.
• If you encounter slow responses, check your network connection or increase timeout settings in your MCP client.
• The server relies on web scraping (via Cheerio) to gather price data; some stores may block scraping or change page layouts, which may require occasional maintenance.
• Ensure Node.js version compatibility with the package, and keep the package up to date to benefit from bug fixes and new features.
• Environment variables can be used to customize behavior (e.g., proxies or rate limits) if supported by the deployed server. Refer to the repository docs for advanced configuration.
• For debugging, run in development mode (npm run dev) to enable hot-reloading and easier iteration.