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 IDq(string, optional): Filter products by titlecategory(string, optional): Filter products by categorybrand(string, optional): Filter products by brandprice(number, optional): Filter products by pricerating(number, optional): Filter products by ratingskip(number, optional, default: 0): Number of products to skiplimit(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:
- Open Cursor
- Press:
- Windows/Linux:
Ctrl + Shift + P - macOS:
Cmd + Shift + P
- Windows/Linux:
- Type "Configure MCP Server" and select it
- 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.