My MCP Server

Mon Marché MCP 服务

一个模型上下文协议（MCP）服务，用于将大模型连接到法国杂货店 Mon Marché。此服务支持 AI 助手搜索商品、管理购物车并与 Mon Marché 平台交互。

功能

• 商品搜索：按名称查找商品。
• 购物车管理：
  • 将商品添加到购物车。
  • 查看当前购物车内容。
  • 清空整个购物车。
• 会话处理：通过 Cookie 自动登录并持久保存会话。支持显式 --session 标志，供脚本或无头模式使用。

前置条件

• Node.js（v16 或更高版本）
• npm 或 yarn
• 有效的 Mon Marché 账户

安装

1. 克隆代码库：

   git clone https://github.com/Chopin85/mcp-server-monmarche
   cd mcp-server-monmarche
   

2. 安装依赖项：

   npm install
   

3. 配置环境： 复制示例环境文件并添加你的凭据：

   cp .env.example .env
   

   编辑 .env 并填写你的详细信息：

   [email protected]
   MON_MARCHE_PASSWORD=your-password
   

4. 构建项目：

   npm run build
   

配置与身份验证

使用 MCP 服务或工具之前，你必须先进行身份验证以生成会话。

运行登录脚本：

npm run login

此命令使用 .env 中的凭据登录，并将会话 Cookie 保存到 session-cookie.json。

重要

如果会话过期或你删除了 session-cookie.json，必须重新运行 npm run login。

使用方法

运行 MCP 服务

要启动服务并通过 MCP 客户端（如 Claude Desktop 或 IDE 扩展）使用：

node dist/index.js

使用 MCP Inspector 测试

你可以使用 MCP Inspector 交互式测试这些工具：

npx @modelcontextprotocol/inspector node dist/index.js

命令行工具

项目包含一些辅助脚本，可直接通过命令行运行工具，用于测试或自动化。

所有命令都支持可选的 --session 标志，以使用显式会话令牌，而非 session-cookie.json：

node dist/utils/cli.js <command> [args...] [--session <token>]

• 搜索：

  npm run searchProducts "pomme"
  

• 添加到购物车：

  npm run addProduct -- --id <PRODUCT_ID> --quantity <QTY>
  

• 查看购物车：

  npm run getCartList
  

• 清空购物车：

  npm run clearCart
  

使用 --session（显式令牌）

直接传入会话令牌，即可跳过 session-cookie.json 文件：

# Direct node usage
node dist/utils/cli.js searchProducts "pasta" --session "abc123"
node dist/utils/cli.js getCartList --session "abc123"
node dist/utils/cli.js addProduct --id "123" --quantity 2 --session "abc123"
node dist/utils/cli.js clearCart --session "abc123"

# Via npm scripts (with -- separator)
npm run searchProducts -- "pasta" --session "abc123"
npm run getCartList -- --session "abc123"
npm run addProduct -- --id "123" --quantity 2 --session "abc123"
npm run clearCart -- --session "abc123"

说明

提供 --session 时，此次调用将忽略 session-cookie.json 文件。

可用工具

此服务向 MCP 客户端提供以下工具：

searchProduct

搜索 Mon Marché 上的商品。

• 输入：{ "name": "string", "session?": "string" }
• 返回：包含商品 ID 和详情的匹配商品列表。

addProduct

将指定商品添加到购物车。

• 输入：{ "id": "string", "quantity": number, "session?": "string" }
• 返回：添加确认信息。

getCartList

获取当前购物车内容。

• 输入：{ "session?": "string" }
• 返回：购物车中的商品列表。

clearCart

从购物车中移除所有商品。

• 输入：{ "session?": "string" }
• 返回：确认消息。

说明

所有工具都接受可选的 session 参数。若省略，则从 session-cookie.json 读取会话。

故障排除

• 登录失败：确保 .env 中的电子邮件和密码正确。
• 会话错误：如果工具返回身份验证错误，请运行 npm run login 刷新会话 Cookie，或通过 --session 传入有效令牌。
• 构建错误：确保已通过 npm install 安装所有依赖项。

许可证

此项目采用 ISC 许可证。