mcp-google-merchant-center 1.0.0

package/README.md

@@ -0,0 +1,81 @@
+# mcp-google-merchant-center
+
+MCP server for Google Merchant Center — read products, check approval statuses, and analyze feeds across multiple accounts.
+
+## Features
+
+- List products across multiple Merchant Center accounts
+- Search products by title or brand
+- Get product approval status and issues
+- Inspect data sources and feeds
+- Get account information
+
+## Installation
+
+```bash
+npm install -g mcp-google-merchant-center
+```
+
+Or use directly with npx (no install needed):
+
+```json
+{
+  "mcpServers": {
+    "merchant-mcp": {
+      "command": "npx",
+      "args": ["-y", "mcp-google-merchant-center"],
+      "env": {
+        "MERCHANT_ID": "YOUR_DEFAULT_MERCHANT_ID",
+        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/application_default_credentials.json"
+      }
+    }
+  }
+}
+```
+
+## Authentication
+
+This server uses Google Application Default Credentials (ADC). Generate them with:
+
+```bash
+gcloud auth application-default login \
+  --client-id-file="YOUR_CLIENT_SECRET.json" \
+  --scopes="https://www.googleapis.com/auth/content"
+```
+
+The credentials file is saved at `~/.config/gcloud/application_default_credentials.json`.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MERCHANT_ID` | Yes | Default Merchant Center account ID |
+| `GOOGLE_APPLICATION_CREDENTIALS` | Yes | Path to ADC credentials JSON file |
+
+## Multiple Accounts
+
+All tools accept an optional `merchant_id` parameter to query a specific account:
+
+> "List products for merchant 5747906518"
+> "Get product status for account 5443978365"
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_account` | Account info and settings |
+| `list_products` | Browse all products with pagination |
+| `get_product` | Full details for a single product |
+| `search_products` | Filter products by title or brand |
+| `list_data_sources` | List feeds and data sources |
+| `get_product_status` | Approval status and disapproval reasons |
+
+## Requirements
+
+- Node.js 18+
+- Google Cloud project with [Merchant API](https://developers.google.com/merchant/api) enabled
+- OAuth 2.0 credentials (Desktop app type)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { google } from "googleapis";
+
+const DEFAULT_MERCHANT_ID = process.env.MERCHANT_ID;
+const ALLOWED_IDS = ["5291449515", "5747906518", "5443978365"];
+const content = google.content("v2.1");
+
+async function getAuth() {
+  const auth = new google.auth.GoogleAuth({
+    keyFile: process.env.GOOGLE_APPLICATION_CREDENTIALS,
+    scopes: ["https://www.googleapis.com/auth/content"],
+  });
+  return auth.getClient();
+}
+
+function resolveMerchantId(id) {
+  const resolved = id ? String(id) : DEFAULT_MERCHANT_ID;
+  if (!ALLOWED_IDS.includes(resolved)) {
+    throw new Error(`Merchant ID ${resolved} non autorizzato. ID disponibili: ${ALLOWED_IDS.join(", ")}`);
+  }
+  return resolved;
+}
+
+const merchantIdProp = {
+  merchant_id: {
+    type: "string",
+    description: `Merchant Center ID (opzionale, default ${DEFAULT_MERCHANT_ID}). Disponibili: ${ALLOWED_IDS.join(", ")}`,
+  },
+};
+
+const server = new Server(
+  { name: "merchant-mcp", version: "1.1.0" },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "get_account",
+      description: "Recupera informazioni sull'account Merchant Center",
+      inputSchema: { type: "object", properties: { ...merchantIdProp } },
+    },
+    {
+      name: "list_products",
+      description: "Lista prodotti nel Merchant Center",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ...merchantIdProp,
+          max_results: { type: "number", description: "Numero massimo di prodotti (default 50)" },
+          page_token: { type: "string", description: "Token per paginazione" },
+        },
+      },
+    },
+    {
+      name: "get_product",
+      description: "Recupera dettagli di un prodotto specifico",
+      inputSchema: {
+        type: "object",
+        required: ["product_id"],
+        properties: {
+          ...merchantIdProp,
+          product_id: { type: "string", description: "ID prodotto (es. online:it:IT:123456)" },
+        },
+      },
+    },
+    {
+      name: "search_products",
+      description: "Cerca prodotti per titolo o brand",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ...merchantIdProp,
+          query: { type: "string", description: "Testo da cercare nel titolo o brand" },
+          max_results: { type: "number", description: "Numero massimo risultati (default 50)" },
+        },
+      },
+    },
+    {
+      name: "list_data_sources",
+      description: "Lista feed e fonti dati del Merchant Center",
+      inputSchema: { type: "object", properties: { ...merchantIdProp } },
+    },
+    {
+      name: "get_product_status",
+      description: "Stato di approvazione e issues dei prodotti",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ...merchantIdProp,
+          max_results: { type: "number", description: "Numero massimo di prodotti (default 50)" },
+        },
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const auth = await getAuth();
+  const args = request.params.arguments || {};
+
+  try {
+    const merchantId = resolveMerchantId(args.merchant_id);
+
+    if (request.params.name === "get_account") {
+      const res = await content.accounts.get({ merchantId, accountId: merchantId, auth });
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+
+    if (request.params.name === "list_products") {
+      const { max_results = 50, page_token } = args;
+      const res = await content.products.list({ merchantId, maxResults: max_results, pageToken: page_token, auth });
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+
+    if (request.params.name === "get_product") {
+      const res = await content.products.get({ merchantId, productId: args.product_id, auth });
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+
+    if (request.params.name === "search_products") {
+      const { query = "", max_results = 50 } = args;
+      const res = await content.products.list({ merchantId, maxResults: 250, auth });
+      const products = (res.data.resources || [])
+        .filter(p =>
+          p.title?.toLowerCase().includes(query.toLowerCase()) ||
+          p.brand?.toLowerCase().includes(query.toLowerCase())
+        )
+        .slice(0, max_results);
+      return { content: [{ type: "text", text: JSON.stringify({ products, total: products.length }, null, 2) }] };
+    }
+
+    if (request.params.name === "list_data_sources") {
+      const res = await content.datafeeds.list({ merchantId, auth });
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+
+    if (request.params.name === "get_product_status") {
+      const { max_results = 50 } = args;
+      const res = await content.productstatuses.list({ merchantId, maxResults: max_results, auth });
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+
+    return { content: [{ type: "text", text: `Tool sconosciuto: ${request.params.name}` }] };
+  } catch (err) {
+    return { content: [{ type: "text", text: `Errore: ${err.message}` }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "mcp-google-merchant-center",
+  "version": "1.0.0",
+  "description": "MCP server for Google Merchant Center — list products, check statuses, and analyze feeds across multiple accounts",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "mcp-google-merchant-center": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "google-merchant-center",
+    "merchant-api",
+    "google-shopping",
+    "products",
+    "ecommerce",
+    "claude"
+  ],
+  "author": "Giovanni Rasulo",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gioenjoy/mcp-google-merchant-center.git"
+  },
+  "homepage": "https://github.com/gioenjoy/mcp-google-merchant-center#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "googleapis": "^173.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}