BigCommerce MCP

A Merchant Control Panel (MCP) tool for BigCommerce built with FastMCP.

Features

• Query BigCommerce products with comprehensive filter parameters
• Pagination support
• Flexible search and filtering options
• Advanced rate limiting handling with automatic retries
• Request queuing to distribute API load
• Response caching to reduce API calls

Installation

As a Local Tool

# Clone the repository
git clone <your-repo-url>
cd bc-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the MCP
npm start

As a Dependency in Another Project

# Install from npm (if published)
npm install bc-mcp

# Or link locally for development
npm link
# Then in your project
npm link bc-mcp

Environment Variables

Create a .env file in the root directory with the following variables:

BIGCOMMERCE_STORE_HASH=your_store_hash
BIGCOMMERCE_ACCESS_TOKEN=your_access_token

Usage

Command Line

# Run the MCP in development mode
npx fastmcp dev src/index.ts

# Run the built version
npm start

In Another Application

import { getProducts } from 'bc-mcp';

// Use the MCP tools
const products = await getProducts({
  limit: 10,
  keyword: 'search term'
});

Docker

You can also run the MCP in a Docker container:

# Build the Docker image
docker build -t bc-mcp .

# Run the container
docker run -e BIGCOMMERCE_STORE_HASH=your_store_hash -e BIGCOMMERCE_ACCESS_TOKEN=your_access_token bc-mcp

License

MIT