isaacgounton/bigcommerce-api-mcp

API development

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

5 stars 4 forks 품질 71 트렌드 21

Repository Install

BigCommerce MCP Server

개요

An MCP server for the BigCommerce REST API. Gives an AI assistant read access to your catalog, customers and orders — and, when you turn it on, the ability to change them. — requires BIGCOMMERCE_ENABLE_WRITES=true Write tools aren't registered at all unless enabled, so a default deployment can't modify your store even if someone reaches its endpoint. npm run list-tools prints the tools and parameters as currently configured. Get both from BigCommerce admin → → → . Grant Products, Orders and Customers — read-only unless you plan to enable writes. .env.example documents every supported variable. HTTP mode serves POST /mcp, plus unauthenticated GET /health and /info. The SSE transport was removed in favour of Streamable HTTP, which replaced it in the MCP spec. Point any client still using /sse at /mcp. In claude_desktop_config.json (use absolute paths — which node):

README

원문 README의 일부입니다. 원문 보기.

BigCommerce MCP Server

An MCP server for the BigCommerce REST API. Gives an AI assistant read access to your catalog, customers and orders — and, when you turn it on, the ability to change them.

Tools

Read

Tool	What it does
`get_all_products`	List products with filtering, sorting and pagination
`get_product`	One product by ID, optionally with variants and images
`get_all_customers`	List customers by ID, email, name, company or date range
`get_all_orders`	List orders by customer, status, date range or total
`get_order`	One order by ID
`get_order_products`	An order’s line items — what was actually bought
`list_categories`	Resolve category names to the IDs product filters need
`list_brands`	Resolve brand names to the IDs product filters need

Write — requires BIGCOMMERCE_ENABLE_WRITES=true

Tool	What it does
`create_product`	Create a catalog product
`update_product`	Update price, stock, visibility, categories…
`create_customer`	Create a customer record
`update_customer`	Update a customer’s details
`update_order`	Change status, staff notes or customer message

Write tools aren’t registered at all unless enabled, so a default deployment can’t modify your store even if someone reaches its endpoint.

npm run list-tools prints the tools and parameters as currently configured.

Setup

Needs Node 20+.

git clone https://github.com/isaacgounton/bigcommerce-api-mcp.git
cd bigcommerce-api-mcp
npm install
cp .env.example .env

Then fill in .env:

BIGCOMMERCE_STORE_HASH=your_store_hash_here
BIGCOMMERCE_API_KEY=your_api_key_here

Get both from BigCommerce admin → Settings → API accounts → Create API account. Grant Products, Orders and Customers — read-only unless you plan to enable writes. .env.example documents every supported variable.

Running

npm start          # stdio — Claude Desktop, Cline, local clients
npm run start:http # streamable HTTP — remote clients and agent runtimes

HTTP mode serves POST /mcp, plus unauthenticated GET /health and /info.

The SSE transport was removed in favour of Streamable HTTP, which replaced it in the MCP spec. Point any client still using /sse at /mcp.

Claude Desktop

In claude_desktop_config.json (use absolute paths — which node):

{
  "mcpServers": {
    "bigcommerce": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/bigcommerce-api-mcp/mcpServer.js"],
      "env": {
        "BIGCOMMERCE_STORE_HASH": "your_store_hash",
        "BIGCOMMERCE_API_KEY": "your_api_key"
      }
    }
  }
}

Over HTTP

curl -X POST http://127.0.0.1:3000/mcp \
  -H "Authorization: Bearer $MCP_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Security

GitHub에서 전체 README 보기

설치

docker run --rm -p 3000:3000 --env-file .env bigcommerce-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "bigcommerce": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/bigcommerce-api-mcp/mcpServer.js"],
      "env": {
        "BIGCOMMERCE_STORE_HASH": "your_store_hash",
        "BIGCOMMERCE_API_KEY": "your_api_key"
      }
    }
  }
}