Bring MCP Server

Bring MCP Server

site icon
2025.04.27 0
TypeScript购物清单管理AI 助手集成开发效率
Bring MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,通过与 Bring Shopping Lists API 的集成,使 AI 助手能够通过自然语言管理购物清单。该项目使用 TypeScript 实现,支持与 Claude、ChatGPT 等 AI 助手的无缝集成。
View on GitHub

Overview

基本能力

产品定位

Bring MCP Server 是一个连接 Bring 购物清单 API 的 MCP 服务器,旨在通过标准化协议使 AI 助手能够管理用户的购物清单。

核心功能

  • MCP 协议支持:实现 Model Context Protocol,便于与 AI 助手集成。
  • Stdio 传输:兼容 Claude for Desktop 等支持 MCP 的客户端。
  • Bring API 集成:完整的 Bring 购物清单 API 集成,包括:
  • 列出所有购物清单
  • 获取购物清单中的物品
  • 添加食谱物品到购物清单
  • 移除特定物品或清空整个购物清单
  • 获取清单物品的详细信息
  • 查看有权访问购物清单的所有用户

适用场景

  • AI 助手通过自然语言管理购物清单。
  • 开发者在开发 AI 助手时集成购物清单管理功能。

工具列表

工具名称 描述
get-bring-lists 列出认证用户的所有购物清单
get-bring-list-items 获取特定购物清单中的所有物品
add-recipe-items-to-bring-list 一次性添加多个物品到购物清单
remove-item-or-all-from-bring-list 移除特定物品或清空整个清单
get-bring-list-items-details 获取清单物品的详细信息
get-all-users-from-bring-list 列出有权访问特定清单的所有用户

常见问题解答

  • 免责声明:该项目使用非官方的 Bring API,这些 API 可能随时更改,导致功能失效。使用风险自负。

使用教程

使用依赖

  • Bring 账户(邮箱和密码)
  • Bring API 密钥

安装教程

  1. 克隆仓库: sh git clone <repository-url> cd bring-mcp-server
  2. 安装依赖: sh npm install
  3. 创建 .env 文件并配置以下变量: md BRING_EMAIL=your_bring_account_email BRING_PASSWORD=your_bring_account_password BRING_API_KEY=your_bring_api_key
  4. 构建项目: md npm run build

调试方式

  1. 启动 MCP 服务器: sh node dist/index.js
  2. 开发模式下运行(带热重载): sh npm run dev
  3. 运行测试: sh npm test

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。