mcp-server-fakestore by habibsalimov - MCP Server

🛍️ MCP Server for Fake Store API

A beginner-friendly Model Context Protocol (MCP) server that provides seamless access to the Fake Store API. Perfect for learning MCP development and building AI applications with e-commerce data.

✨ Features

🚀 Easy to Use: Simple setup and configuration
🔧 10 MCP Tools: Complete access to products, carts, and users
📦 TypeScript: Full type safety and IntelliSense support
⚡ Response Caching: Built-in caching for better performance
📝 Comprehensive Logging: Winston-powered logging system
✅ Well Tested: Jest test suite with high coverage
📖 Well Documented: Extensive documentation and examples

📋 Prerequisites

Node.js >= 18.0.0
npm >= 9.0.0

🚀 Quick Start

Installation

npm install -g @habibsalimov/mcp-server-fakestore

Usage with Claude Desktop

Add the server configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fakestore": {
      "command": "npx",
      "args": ["-y", "@habibsalimov/mcp-server-fakestore"]
    }
  }
}

Restart Claude Desktop, and you're ready to go!

🛠️ Available Tools

Products (4 tools)

Tool Name	Description	Parameters
`fakestore_get_products`	Get all products	`limit?`, `sort?`
`fakestore_get_product`	Get single product by ID	`id`
`fakestore_get_categories`	Get all categories	-
`fakestore_get_products_by_category`	Get products by category	`category`

Carts (3 tools)

Tool Name	Description	Parameters
`fakestore_get_carts`	Get all shopping carts	`limit?`, `sort?`
`fakestore_get_cart`	Get single cart by ID	`id`
`fakestore_get_user_carts`	Get carts for a user	`userId`

Users (2 tools)

Tool Name	Description	Parameters
`fakestore_get_users`	Get all users	`limit?`
`fakestore_get_user`	Get single user by ID	`id`

💡 Example Usage with Claude

You: "Show me all electronics products"
Claude: *Uses fakestore_get_products_by_category with category="electronics"*

You: "What's in user 1's shopping cart?"
Claude: *Uses fakestore_get_user_carts with userId=1*

You: "Get details for product ID 5"
Claude: *Uses fakestore_get_product with id=5*

🏗️ Development

Clone and Install

git clone https://github.com/habibsalimov/mcp-server-fakestore.git
cd mcp-server-fakestore
npm install

Build

npm run build

Run Tests

npm test
npm run test:coverage

Lint and Format

npm run lint
npm run format

Development Mode

npm run dev

📁 Project Structure

mcp-server-fakestore/
├── src/
│   ├── api/              # API client and endpoints
│   ├── tools/            # MCP tools implementation
│   ├── types/            # TypeScript type definitions
│   ├── utils/            # Utility functions
│   ├── server.ts         # MCP server setup
│   └── index.ts          # Entry point
├── tests/                # Jest tests
├── docs/                 # Documentation
├── examples/             # Usage examples
└── dist/                 # Compiled output

📚 Documentation

- Detailed installation and configuration
- Examples and use cases
- How to contribute
- Technical architecture

🤝 Contributing

Contributions are welcome! Please read our for details.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

Fake Store API for providing the e-commerce data
Model Context Protocol by Anthropic
Claude by Anthropic

📧 Support

Made with ❤️ by Habib Salimov