接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
uvx gmc-mcp==0.3.0Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
GMC_ACCOUNT_ID=<value> GMC_SERVICE_ACCOUNT_KEY=<secret> GMC_OAUTH_TOKEN=<secret> GMC_SUBACCOUNT_ID=<value> GMC_DRY_RUN=<value> GMC_LOG_LEVEL=<value> claude mcp add kiwoongeom-gmc-mcp -- uvx gmc-mcp==0.3.0在終端機中執行。
{ "mcpServers": { "kiwoongeom-gmc-mcp": { "command": "uvx", "args": [ "gmc-mcp==0.3.0" ], "env": { "GMC_ACCOUNT_ID": "<value>", "GMC_SERVICE_ACCOUNT_KEY": "<secret>", "GMC_OAUTH_TOKEN": "<secret>", "GMC_SUBACCOUNT_ID": "<value>", "GMC_DRY_RUN": "<value>", "GMC_LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
The first free, open-source, self-hosted MCP server for Google Merchant Center (GMC). 126 tools over Merchant API v1 — products, inventory, reports, promotions, returns, account config, audit log + rollback, dry-run. Free alternative to paid SaaS (Adzviser, Catchr, Windsor.ai, Pipedream).
MCP server for Google Merchant Center, built on Merchant API v1. 126 tools, MIT-licensed,
pip install-able. Drive your Google Shopping feed, products, inventory, Reports, promotions, returns, and account configuration in natural language from Claude Desktop, Claude Code, or any MCP-compatible client.Where this fits in the GMC + MCP landscape
Pick this if you want: future-proof API, an actual OSS license, PyPI install, a larger toolset, audit log + rollback + dry-run safety, and credentials that never leave your machine.
Built on Merchant API v1 (replaces Content API for Shopping; v1beta was
discontinued 2026-02-28). Safe by default: every write is recorded to an
append-only audit log with before snapshots, dry-run is one toggle away, and
destructive bulk operations require an explicit confirm parameter.
Google Merchant Center (GMC) powers Google Shopping listings, Free Listings, Shopping Ads, Buy on Google checkout, YouTube Shopping, and more. Managing a feed of thousands of products through the GMC web UI is tedious, and writing one-off Python scripts against the Merchant API REST endpoints is slow.
There are existing MCP services for GMC, but they fit different niches:
archpeng/GMC-mcp-server — earliest self-hosted Python option (Feb 2026),
but built on the deprecated Content API v2.1 which Google retires in
August 2026, has no license declared, and isn't on PyPI.gmc-mcp was built to fill the gap: a self-hosted package on the new
Merchant API v1, MIT-licensed, on PyPI, with audit/rollback/dry-run
safety and 126 tools across 19 modules.
The package gives Claude (or any MCP client) 126 tools that map directly onto the Merchant API v1 surface, so you can do things like:
126 tools across 19 modules + 4 meta tools.
CLI also exposes: gmc-mcp run, auth-init, register-gcp, webhook, describe, version.
pip install gmc-mcp
For development:
git clone https://github.com/kiwoongeom/gmc-mcp
cd gmc-mcp
pip install -e ".[dev,test]"
pre-commit install
gmc-mcp.[email protected] email → grant Admin.cp .env.example .env
# edit:
# GMC_ACCOUNT_ID=1234567890
# GMC_SERVICE_ACCOUNT_KEY=/abs/path/to/service-account.json
Required before any v1 Merchant API call works for a new project.
gmc-mcp register-gcp --developer-email [email protected]
gmc-mcp describe # prints the resolved config
python examples/quickstart.py # makes one read against the Merchant API
Drop this into %APPDATA%/Claude/claude_desktop_config.json (Desktop) or ~/.claude/settings.json (Code):
{
"mcpServers": {
"gmc": {
"command": "gmc-mcp",
"args": ["run"],
"env": {
"GMC_ACCOUNT_ID": "1234567890",
"GMC_SERVICE_ACCOUNT_KEY": "/abs/path/to/service-account.json"
}
}
}
}
Restart Claude. Ask: "What account am I connected to?" — it should call gmc_describe_server.
For acting on behalf of an end user (e.g. multi-tenant SaaS):
# 1. In GCP, create OAuth client credentials (type: Desktop), download client_secret.json.
gmc-mcp auth-init --client-secrets ./client_secret.json
# follow the browser flow; a token JSON is saved to secrets/oauth-token.json.
# 2. Use it
export GMC_OAUTH_TOKEN=./secrets/oauth-token.json
gmc-mcp run
gmc-mcp run # stdio (Claude Desktop default)
gmc-mcp run --transport sse --port 8000 # SSE / HTTP (remote, Docker, hosted)
Or via Docker:
docker build -t gmc-mcp .
docker run --rm -p 8000:8000 \
-e GMC_ACCOUNT_ID=1234567890 \
-v $PWD/secrets:/secrets \
-e GMC_SERVICE_ACCOUNT_KEY=/secrets/service-account.json \
gmc-mcp
Every write logs a JSONL entry to GMC_AUDIT_LOG (default: ./logs/audit.jsonl). Each entry contains:
audit_id — UUID for lookupop, method, url, request_body, response_status, response_bodybefore — pre-write snapshot when the tool fetched it (used by update_* and delete_*)dry_run — whether the request was actually sentInspect from inside Claude:
> Show me my last 5 GMC writes.
[gmc_audit_tail(limit=5) → ...]
> Look up audit ID abc123.
[gmc_audit_lookup(audit_id="abc123") → ...]
> Roll back audit ID abc123, that update was wrong.
[gmc_rollback(audit_id="abc123", confirm="ROLLBACK") → ...]
Two ways to enable:
GMC_DRY_RUN=true gmc-mcp run
> Set dry-run on and update the price of SKU1 to $19.99.
[gmc_set_dry_run(enabled=True) → ok]
[gmc_update_regional_inventory(...) → {"_dry_run": true, ...}]
Reads always go through; only writes are skipped.
Paste into gmc_query_report:
-- Top 50 by clicks last 7 days
SELECT offer_id, title, clicks, impressions, ctr
FROM product_performance_view
WHERE date BETWEEN '2026-04-23' AND '2026-04-30'
ORDER BY clicks DESC LIMIT 50
-- Disapproved products with reason codes
SELECT id, offer_id, title, item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'
-- You're priced higher than the benchmark
SELECT offer_id, title, price, benchmark_price
FROM price_competitiveness_product_view
WHERE price > benchmark_price LIMIT 100
All config is via env vars (or .env). CLI flags --transport, --host, --port, --env override.
Claude (any MCP client)
│ JSON-RPC over stdio or SSE
▼
gmc-mcp server ──► audit.jsonl
│
│ HTTP + Bearer token
▼
merchantapi.googleapis.com ──► Google Merchant Center
auth.py — ServiceAccountAuth and OAuthUserAuth share an Auth protocol.client.py — single MerchantClient with retries (5x w/ jitter), pagination helper, and write-audit hook.tools/*.py — each module exposes a register(mcp, client) that registers @mcp.tool() functions.audit.py — append-only JSONL, lookup by ID, supports before snapshots.cli.py — gmc-mcp run | auth-init | register-gcp | webhook | describe | version.pytest # 100% offline; uses respx to mock HTTP
pytest --cov=gmc_mcp # with coverage
ruff check src tests
mypy src/gmc_mcp
gmc_subscribe callbacks)See CONTRIBUTING.md. PRs and issues welcome — this is the first open-source MCP for Google Merchant Center, so there's a lot of room for community input on which workflows deserve dedicated tools.
MIT — see LICENSE.
Search keywords: Google Merchant Center MCP, GMC MCP, Merchant API MCP, Google Shopping MCP, Shopping Ads MCP, free listings MCP, Claude Desktop Google Merchant Center, MCP for ecommerce, Shopify Google Merchant Center automation.
The first free, open-source, self-hosted MCP server for Google Merchant Center (GMC). 126 tools over Merchant API v1 — products, inventory, reports, promotions, returns, account config, audit log + ro
{ "mcpServers": { "kiwoongeom-gmc-mcp": { "command": "uvx", "args": [ "gmc-mcp==0.3.0" ], "env": { "GMC_ACCOUNT_ID": "<value>", "GMC_SERVICE_ACCOUNT_KEY": "<secret>", "GMC_OAUTH_TOKEN": "<secret>", "GMC_SUBACCOUNT_ID": "<value>", "GMC_DRY_RUN": "<value>", "GMC_LOG_LEVEL": "<value>" } } }}總覽
The first free, open-source, self-hosted MCP server for Google Merchant Center (GMC). 126 tools over Merchant API v1 — products, inventory, reports, promotions, returns, account config, audit log + rollback, dry-run. Free alternative to paid SaaS (Adzviser, Catchr, Windsor.ai, Pipedream).
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:GMC_ACCOUNT_ID, GMC_SERVICE_ACCOUNT_KEY, GMC_OAUTH_TOKEN, GMC_SUBACCOUNT_ID, GMC_DRY_RUN, GMC_LOG_LEVEL。
Gmc 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 The first free, open-source, self-hosted MCP server for Google Merchant Center (GMC). 126 tools over Merchant API v1 — products, inventory, reports, promotions, returns, account config, audit log + rollback, dry-run. Free alternative to paid SaaS (Adzviser, Catchr, Windsor.ai, Pipedream).