Skip to main content
Glama
Sign In
deenesjakoruzh
bhs-mcp

bhs-mcp

by jackemcpherson
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

bhs-mcp

MCP-сервер для данных о продуктах Blackhearts & Sparrows, развернутый как Cloudflare Worker.

Использует паттерн Code Mode — LLM пишет код на TypeScript, который выполняется через типизированный API BHS в изолированном Dynamic Worker, вместо прямого вызова фиксированных инструментов.

Архитектура

LLM -> code tool -> Dynamic Worker (sandbox)
                        | bhs.search(...)
                     BhsProxy (RPC bridge)
                        |
                     Host Worker
                        |
                     Meilisearch / GraphQL APIs

Песочница не имеет доступа к сети. Все внешние вызовы проходят через RPC-мост BhsProxy к хост-воркеру.

Related MCP server: Kibo Commerce MCP Server

Инструменты MCP

Инструмент

Описание

schema

Определения типов TypeScript, сигнатуры методов и примеры запросов

tools

Возможности песочницы, ограничения и рекомендации

code

Выполнение TypeScript с доступом к объекту API bhs

API песочницы

// Search products
const wines = await bhs.search({ type: "Wine", country: "France", priceMax: 30 });

// Get product details
const product = await bhs.product("44253");

// List stores
const stores = await bhs.stores();

// Manage cart
const cart = await bhs.cart.create();
await bhs.cart.addItems(cart.uid, [{ sku: "44253", masterSku: "44253", quantity: 6 }]);
const url = bhs.cart.checkoutUrl(cart.uid);

Разработка

npm install
npm run dev        # wrangler dev
npm run typecheck  # tsc --noEmit
npm run deploy     # wrangler deploy

Развертывание

Маршрут: bhs.jackemcpherson.com/mcp*

Зависит от @jackemcpherson/bhs-cli для функций API и типов.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Google Workspace Code MCP

      mitsuhiko
      A
      license
      B
      quality
      D
      maintenance
      A code-first MCP server that provides a single tool to execute JavaScript or TypeScript with authenticated access to Google Workspace APIs. It enables flexible interactions with services like Calendar and Drive by running user-provided scripts through a built-in runtime environment.
      1
      7
      MIT

    • bun-runner-mcp

      timoconnellaus
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that executes TypeScript/JavaScript code in a sandboxed Bun environment with permission-based security controls, code snippets, and a web management UI.
      -

    • trundler

      auckland-ai-collective
      A
      license
      A
      quality
      B
      maintenance
      A local MCP server for grocery shopping, enabling product search, specials, and browsing across NZ supermarkets, with cart and order history for Countdown/Woolworths via browser-assisted login.
      14
      1
      MIT