MCP 服务器

fake-store-mcp

Provides AI assistants with access to the Fake Store API for e-commerce prototyping and testing, enabling queries on products, carts, and users.

README

Fake Store MCP Server

A Model Context Protocol (MCP) server that provides AI assistants like Claude with access to the Fake Store API - a free REST API for e-commerce prototyping and testing.

Features

9 Ready-to-Use Tools for products, carts, and users
Full TypeScript Support with strict type safety
Production-Ready with retry logic and error handling
Zero Configuration - works out of the box
Beginner-Friendly - great for learning MCP development

Available Tools

Products

list_products - Get all products with pagination and sorting
get_product - Get detailed product information by ID
list_categories - Get all available product categories
get_products_by_category - Filter products by category

Carts

list_carts - Get all shopping carts
get_cart - Get cart details by ID
get_user_carts - Get all carts for a specific user

Users

list_users - Get all users
get_user - Get user details by ID

Installation

For Claude Desktop

Install the package:

npm install -g fake-store-mcp

Configure Claude Desktop:

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add the following configuration:

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

Alternative (if installed globally):

{
  "mcpServers": {
    "fake-store": {
      "command": "fake-store-mcp"
    }
  }
}

Restart Claude Desktop

The tools will now be available in your Claude conversations!

For Other MCP Clients

If you're using another MCP-compatible client, you can run the server directly:

npx fake-store-mcp

Or install it locally in your project:

npm install fake-store-mcp

Usage Examples

Example 1: Browsing Products

User: "Show me the first 5 products from the store"

Claude: Uses list_products tool with limit: 5

Example 2: Product Search

User: "What electronics products are available?"

Claude: Uses list_categories first, then get_products_by_category with category: "electronics"

Example 3: User Cart Analysis

User: "Show me what user 1 has in their shopping carts"

Claude: Uses get_user_carts with userId: 1

Example 4: Product Details

User: "Tell me more about product ID 5"

Claude: Uses get_product with id: 5

Tool Parameters

list_products

{
  limit?: number;      // Limit number of results
  sort?: 'asc' | 'desc'; // Sort order
}

get_product

{
  id: number;          // Product ID (required)
}

list_categories

No parameters required.

get_products_by_category

{
  category: string;    // Category name (required)
  limit?: number;      // Limit number of results
  sort?: 'asc' | 'desc'; // Sort order
}

list_carts

{
  limit?: number;      // Limit number of results
  sort?: 'asc' | 'desc'; // Sort order
}

get_cart

{
  id: number;          // Cart ID (required)
}

get_user_carts

{
  userId: number;      // User ID (required)
}

list_users

{
  limit?: number;      // Limit number of results
  sort?: 'asc' | 'desc'; // Sort order
}

get_user

{
  id: number;          // User ID (required)
}

Development

Prerequisites

Node.js 18 or higher
npm or yarn

Setup

# Clone the repository
git clone https://github.com/ckaraca/fake-store-mcp.git
cd fake-store-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode (auto-rebuild on changes)
npm run dev

Project Structure

fake-store-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── tools/
│   │   ├── products.ts       # Product tools
│   │   ├── carts.ts          # Cart tools
│   │   └── users.ts          # User tools
│   ├── api/
│   │   ├── client.ts         # HTTP client with retry logic
│   │   └── types.ts          # TypeScript type definitions
│   └── utils/
│       └── error-handler.ts  # Error handling utilities
├── dist/                     # Compiled output
└── package.json