Good Nature Vibe Catalog

com.goodnaturevibe由 goodnaturevibe.com 發布官方發布者v0.1.0更新於 Nov 3, 2026

Good Nature Vibe 商店的公開唯讀目錄與知識庫。無需登入。

AI 翻譯由 AI 模型根據下方的原文描述翻譯,可能有誤。

原文描述

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

發布方自己的服務:Good Nature Vibe

已驗證Streamable HTTP可網頁執行

概覽

Good Nature Vibe Catalog 的託管 MCP 服務(catalog-mcp.goodnaturevibe.com),由 goodnaturevibe.com 發布;無需登入;Streamable HTTP;6 個工具。

暫無 AI 概覽:以下資訊來自註冊中心條目和服務本身。

發布者
goodnaturevibe.com
端點
catalog-mcp.goodnaturevibe.com
最近檢查

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Good Nature Vibe Catalog,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.goodnaturevibe%2Fcatalog/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "good-nature-vibe-catalog": {
      "type": "http",
      "url": "https://catalog-mcp.goodnaturevibe.com/mcp"
    }
  }
}

README

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:

bash
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.

bash
GNV_CATALOG_PORT=8325 node src/main.jscurl -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:

bash
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.

來源:README.md,提交 74b7ca8

工具

6

gnv_product

One product with variants

One product from the feed, with variants, a price range and the public product text. NL: één product uit de feed, met varianten, prijsrange en publieke tekst.

輸入參數sku必填store

gnv_knowledge

Read one page or blog post

Full plain text of one CMS page or blog post from the feed. NL: volledige platte tekst van één CMS-pagina of blogartikel.

輸入參數id必填store

gnv_profile

Merchant profile

Merchant profile of Good Nature Vibe. NL: merchantprofiel van Good Nature Vibe.

無需輸入參數。

gnv_contact

Shop contact

Public contact path of the shop. NL: publiek contactpad van de winkel.

無需輸入參數。

版本歷史

1
  1. v0.1.0最新Nov 3, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Goodnaturevibe 整合