Products API MCP Server

My First MCP Project

This project demonstrates the use of MCP (Model Context Protocol) server that retrieves data from the DummyJSON API. Built using Cursor IDE with the default agent.

Table of Contents

Features

Products API Tools

  • get_products
    • Description: Get a list of products with optional filtering and pagination
    • Parameters:
      • id (string, optional): Filter products by ID
      • q (string, optional): Filter products by title
      • category (string, optional): Filter products by category
      • brand (string, optional): Filter products by brand
      • price (number, optional): Filter products by price
      • rating (number, optional): Filter products by rating
      • skip (number, optional, default: 0): Number of products to skip
      • limit (number, optional, default: 10): Maximum number of products to return
    • Returns: A list of products matching the specified criteria
    • Data Source: DummyJSON API (https://dummyjson.com/products)

Installation and Usage

Prerequisites

  • Node.js (version 23 or higher)
  • Docker and Docker Compose
  • WSL2 (if using Windows)

Cursor Configuration

To configure this MCP server with Cursor:

  1. Open Cursor
  2. Press:
    • Windows/Linux: Ctrl + Shift + P
    • macOS: Cmd + Shift + P
  3. Type "Configure MCP Server" and select it
  4. Add the appropriate configuration based on your setup:
For Windows (without WSL) or Linux:
{ "mcpServers": { "postgres": { "command": "node", "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"] } } }
For WSL Users:
{ "mcpServers": { "postgres": { "command": "wsl.exe", "args": [ "-e", "ABSOLUTE_PATH_TO_NODE/.nvm/versions/node/v23.11.0/bin/node", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts" ] } } }

To find your Node.js path, run:

which node

License

This project is licensed under the MIT License.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that retrieves product data from the DummyJSON API, supporting filtering by various parameters like ID, title, category, brand, price and rating.

  1. Table of Contents
    1. Features
      1. Products API Tools
    2. Installation and Usage
      1. Prerequisites
    3. Cursor Configuration
      1. For Windows (without WSL) or Linux:
      2. For WSL Users:
    4. License

      Related MCP Servers

      • A
        security
        F
        license
        A
        quality
        A lightweight, stateless MCP server utilizing Puppeteer for web searches, returning structured JSON results, easily integratable with other MCP-enabled systems.
        Last updated -
        1
        1,261
        JavaScript
      • A
        security
        A
        license
        A
        quality
        An API server that implements the Model Completion Protocol (MCP) for Cryo blockchain data extraction, allowing users to query Ethereum blockchain data through any MCP-compatible client.
        Last updated -
        5
        86
        Python
        MIT License
        • Linux
        • Apple
      • -
        security
        A
        license
        -
        quality
        An MCP server that enables fetching web content using the Node.js undici library, supporting various HTTP methods, content formats, and request configurations.
        Last updated -
        66
        8
        TypeScript
        MIT License
        • Apple
        • Linux
      • A
        security
        F
        license
        A
        quality
        An MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.
        Last updated -
        39
        25
        • Apple

      View all related MCP servers

      ID: 8bezdst020