AI导哈

购物清单管理服务

Listonic MCP Server是一个用于管理购物清单的服务，支持查看、添加、删除和更新购物清单中的物品。

  • by WavyWare
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 WavyWare/listonic-mcp

使用说明

Listonic MCP服务器

用于与集成的模型上下文协议（MCP）服务器 列表.直接通过兼容MCP的AI客户端管理您的购物清单、添加商品和组织您的杂货店。

特性

  • 管理购物清单：查看所有列表及其元数据。
  • 内容检查：看看每个列表上到底有什么。
  • 项目管理：添加新产品或删除已完成的产品。
  • 列表创建：从头开始创建新的购物清单。
  • 切换项目：购物时勾选或取消勾选商品。

安装

  1. 将存储库克隆或复制到本地计算机。
  2. 导航到项目目录：
    cd listonic-mcp
  3. 安装依赖项：
    npm install
  4. 构建项目：
    npm run build

认证

Listonic不提供公共API。此服务器使用非官方集成，需要 刷新令牌.

如何获取刷新令牌：

  1. 登录到 Listonic网络应用程序 在您的浏览器中。
  2. 打开 开发者工具 （F12或右键单击->检查）。
  3. 去 网络 选项卡。
  4. 添加项目或刷新页面。查找名为的请求 loginextended.
  5. 点击请求并查看 回应 身体。
  6. 复制 refresh_token 价值。

在MCP客户端中设置Auth：

第一次使用服务器时，调用 login 工具：

  • 工具： login
  • 论据： { "refreshToken": "YOUR_EXTRACTED_REFRESH_TOKEN" }

然后，服务器将使用此令牌来保持会话活动。

MCP客户端的配置

将以下内容添加到您的MCP配置中（例如，在Claude Desktop或类似设备中）：

{
  "mcpServers": {
    "listonic": {
      "command": "node",
      "args": ["/absolute/path/to/listonic-mcp/build/index.js"]
    }
  }
}

可用工具

  • login：身份验证的第一步。接受 refreshToken （推荐）或 email/password （实验）。
  • get_lists：返回所有购物清单及其ID。
  • get_list_items：获取特定项目的所有项目 listId.
  • add_item：按名称将产品添加到列表中。
  • remove_items：按数字ID删除项目。
  • create_list：创建新的购物清单。
  • update_item：更新项目（选中/取消选中或重命名）。

发展

  • npm run dev：直接使用以下命令运行服务器 ts-node.
  • npm run build：将TypeScript编译为JavaScript。
  • npm start：运行已编译的服务器。

免责声明

本项目不隶属于Listonic，也不由Listonic维护、授权、背书或赞助。使用风险自负。

相关 MCP