
Bring MCP Server

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 密钥
安装教程
- 克隆仓库:
sh git clone <repository-url> cd bring-mcp-server
- 安装依赖:
sh npm install
- 创建
.env
文件并配置以下变量:md BRING_EMAIL=your_bring_account_email BRING_PASSWORD=your_bring_account_password BRING_API_KEY=your_bring_api_key
- 构建项目:
md npm run build
调试方式
- 启动 MCP 服务器:
sh node dist/index.js
- 开发模式下运行(带热重载):
sh npm run dev
- 运行测试:
sh npm test