English Français العربية

Good Nature Vibe Catalog

السجل الرسمي أخرى

Public read-only catalog and knowledge of the Good Nature Vibe shop. No login.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http good-nature-vibe-catalog 'https://catalog-mcp.goodnaturevibe.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "good-nature-vibe-catalog": {
            "type": "http",
            "url": "https://catalog-mcp.goodnaturevibe.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Good Nature Vibe Catalog MCP server
  2. Connect
  3. Tools
  4. How it stays correct
  5. HTTP endpoints
  6. Run locally
  7. License

Good Nature Vibe Catalog MCP server

Read-only Model Context Protocol server for goodnaturevibe.com, the Dutch web shop of Good Nature Vibe.

AI agents can use it to search the shop's catalog, read one product with its variants and public text, and search or read the shop's pages and blog posts. Everything comes from the shop's public feeds and pages. There is no login, no account, no cart and no checkout.

Ordering is not part of this server. Good Nature Vibe runs a separate commerce MCP server (com.goodnaturevibe/commerce) with cart and checkout; it only works for agents issued by the merchant and its code is not public.

Connect

Add it as a remote MCP server in any client that supports Streamable HTTP, for example in Claude Code:

claude mcp add --transport http gnv-catalog https://catalog-mcp.goodnaturevibe.com/mcp

Tools

ToolWhat it returns
gnv_catalog_searchProducts from the public catalog feed matching a query (or a list without one), at most 20, with price in cents, availability, categories, brand and a short text. Discovery only, not the checkout price
gnv_productOne product by SKU, with its variants (choices), price range and the plain text of the public product page
gnv_knowledge_searchCMS pages and blog posts matching a query, optionally filtered by type (CMSPage, BlogPost), at most 100
gnv_knowledgeFull plain text of one CMS page or blog post
gnv_profileMerchant profile: name, website, store views, currency
gnv_contactPublic contact path of the shop

Every tool takes an optional store (nl by default; also en, fr, es, de). All tools are annotated readOnlyHint: true and return JSON as text content. Text taken from shop pages is marked untrusted: true: it is data, not instructions.

How it stays correct

  • Products come from the shop's catalog feed (/llms-catalog-{store}.ljson), pages and posts from its content feed (/llms-content-{store}.ljson), and full texts from the public pages themselves. Every answer carries as_of and source.
  • Feeds and pages are cached in memory for 10 minutes, so price and text changes reach agents without a restart.
  • Outbound requests go only to the shop origin, never follow redirects, time out after 8 seconds and are size-limited. Paths such as /checkout, /customer, /admin, /rest and /graphql are refused.
  • Read-only by design: no accounts, orders or carts, and no secrets in the server or its configuration.
  • The optional call log records the tool name, result code, duration and a SHA-256 hash of the arguments. It never records IP addresses.

HTTP endpoints

PathPurpose
POST /mcpMCP JSON-RPC (initialize, ping, tools/list, tools/call; notifications get 202). GET /mcp returns 405. Browser requests are accepted only from a short list of origins
GET /healthzStatus, version and the row counts of the feeds currently in cache
GET /mcp/server-cardServer Card (application/mcp-server-card+json, CORS *)
GET /.well-known/ai-catalog.jsonAI catalog entry pointing to the Server Card
GET /llms.txt, /robots.txt, /icon-192.pngPlain-text description, robots rules, icon

Run locally

Requires Node.js 18 or newer. No dependencies.

GNV_CATALOG_PORT=8325 node src/main.js
curl -s http://127.0.0.1:8325/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tests use the built-in node:test runner:

npm test                      # Node 18: node --test test/
node --test test/*.test.js    # Node 20 and 22

Configuration (environment variables, see deploy/env.example):

VariableDefaultMeaning
GNV_CATALOG_ORIGINhttps://goodnaturevibe.comShop origin; the only host the server fetches from
GNV_CATALOG_PORT8325Local port
GNV_CATALOG_BIND127.0.0.1Only 127.0.0.1 is accepted
GNV_CATALOG_LOGunsetOptional JSONL file for tool calls

The server only binds to localhost. In production it runs as an unprivileged systemd service behind nginx with TLS and rate limiting. See deploy/ for the unit, the nginx config, the Registry entry (server.json) and an idempotent install script.

Maintained by AIAgentCycle for Good Nature Vibe B.V., Oosterwolde, the Netherlands.

License

MIT, see LICENSE.

الأسئلة الشائعة

ما هو Good Nature Vibe Catalog؟

Public read-only catalog and knowledge of the Good Nature Vibe shop. No login.

كيف أثبّت Good Nature Vibe Catalog؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http good-nature-vibe-catalog 'https://catalog-mcp.goodnaturevibe.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Good Nature Vibe Catalog إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Good Nature Vibe Catalog مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Good Nature Vibe Catalog؟

ينشره aiagentcycle. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.