В этом проекте реализован локальный сервер Model Context Protocol (MCP) в TypeScript, который раскрывает функциональные возможности Bring! Список покупок API. Это позволяет приложениям, таким как Claude Desktop, взаимодействовать с вашим приложением Bring! Списки покупок с использованием стандартизированных инструментов MCP.

Сервер интегрирует npm-пакет для Bring! Доступ к API и использование пакета сервера MCP TypeScript SDK v2 для обеспечения совместимого с MCP интерфейса.

** Отказ от ответственности: ** Это личный проект. Я не связан с Bring! Labs AG в любом случае. Этот проект использует ** неофициальный Bring! API**, который может изменяться или блокироваться в любое время. Это может привести к остановке работы сервера MCP без предварительного уведомления.

Рекомендуемая конфигурация Claude Desktop

Чтобы использовать этот сервер в Claude Desktop через npx, вставьте следующее в свой claude_desktop_config.json файл:

Это рекомендуемая и самая портативная конфигурация. Это гарантирует, что вы всегда используете последнюю версию, опубликованную в npm, без необходимости локальной установки.

Использование с ChatGPT через OpenAI Secure MCP Tunnel

OpenAI Secure MCP Tunnel позволяет ChatGPT достичь этого сервера STDIO, не разоблачая его через общедоступную конечную точку.

MCP Server for Bring! Shopping

This project implements a local Model Context Protocol (MCP) server in TypeScript that exposes the functionalities of the Bring! shopping list API. It enables applications like Claude Desktop to interact with your Bring! shopping lists using standardized MCP tools.

The server integrates the bring-shopping npm package for Bring! API access and uses the MCP TypeScript SDK v2 server package to provide an MCP-compliant interface.

Disclaimer:
This is a personal project. I am not affiliated with Bring! Labs AG in any way.
This project uses an unofficial Bring! API, which may change or be blocked at any time.
This could cause the MCP server to stop functioning without prior notice.

---

🧩 Recommended Claude Desktop Configuration

To use this server in Claude Desktop via npx, insert the following into your claude_desktop_config.json file:

{
  "mcpServers": {
    "bring-mcp": {
      "command": "npx",
      "args": ["-y", "bring-mcp@latest"],
      "env": {
        "BRING_EMAIL": "[email protected]",
        "BRING_PASSWORD": "YOUR_BRING_PASSWORD_HERE"
      }
    }
  }
}

This is the recommended and most portable configuration. It ensures you always use the latest version published to npm without needing local installation.

---

💬 Using with ChatGPT via OpenAI Secure MCP Tunnel

OpenAI Secure MCP Tunnel lets ChatGPT reach this STDIO server without exposing it through a public endpoint. The tunnel client itself is provided as a downloadable binary, while bring-mcp can still be launched through npx without a local checkout or installation.

Prerequisites

• Node.js 22 or newer, including npm/npx
• ChatGPT developer-mode access
• Tunnels Read + Use permissions in the relevant OpenAI Platform organization
• A tunnel ID and runtime API key from OpenAI Platform tunnel settings
• The tunnel-client binary, available from the download link in the tunnel settings

When creating the tunnel, associate it with the ChatGPT workspace in which you want to use Bring. Otherwise, it will not appear when creating the ChatGPT connection.

Configure and run the tunnel

Export the tunnel API key and your Bring! credentials in the shell that will run tunnel-client:

export CONTROL_PLANE_API_KEY="sk-..."
export BRING_EMAIL="[email protected]"
export BRING_PASSWORD="YOUR_BRING_PASSWORD_HERE"

Create a tunnel profile that starts the latest published bring-mcp package through npx:

tunnel-client init \
  --sample sample_mcp_stdio_local \
  --profile bring-mcp \
  --tunnel-id tunnel_0123456789abcdef0123456789abcdef \
  --mcp-command "npx -y bring-mcp@latest"

Validate the configuration, then start the tunnel: