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"
      }
    }
  }
}