MCP Server Monmarche

我的MCP服务器市场

将LLM连接到的模型上下文协议（MCP）服务器 我的市场 法国杂货店。该服务器使AI助手能够搜索产品、管理购物车并与Mon Marché平台进行交互。

特性

• 产品搜索：按名称查找产品。
• 购物车管理:

- 将商品添加到购物车。 - 查看当前购物车内容。 - 清空整个购物车。

• 会话处理：通过Cookie自动登录和会话持久化。

先决条件

• Node.js（v16或更高版本）
• npm或纱线
• A有效 我的市场 账户

安装

1. 克隆存储库：

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

1. 安装依赖项：

   npm install

1. 配置环境：

复制示例环境文件并添加您的凭据：

   cp .env.example .env

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

   MON_MARCHE_EMAIL=your-email@example.com
   MON_MARCHE_PASSWORD=your-password

1. 构建项目：

   npm run build

配置和身份验证

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

运行登录脚本：

npm run login

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

\[！重要\] 你必须重新运行 npm run login 如果您的会话到期或您删除 session-cookie.json.

用法

运行MCP服务器

要启动服务器以与MCP客户端（如Claude Desktop或IDE扩展）一起使用：

node dist/index.js

MCP检验员测试

您可以使用MCP检查器交互式测试工具：

npx @modelcontextprotocol/inspector node dist/index.js

CLI工具

该项目包括帮助脚本，可以直接从命令行运行工具进行测试或自动化：

• 搜索: npm run searchProducts "pomme"
• 加入购物车: `npm run addProduct -- --id

--quantity `

• 查看购物车: npm run getCartList
• 清空购物车: npm run clearCart

可用工具

服务器向MCP客户端公开以下工具：

searchProduct

在Mon Marché上搜索产品。

• 输入: { "query": { "name": "string" } }
• 退货：带有ID和详细信息的匹配产品列表。

addProduct

将特定产品添加到购物车。

• 输入: { "product": { "id": "string", "quantity": number } }
• 退货：确认添加。

getCartList

检索购物车的当前内容。

• 输入: {} （无需输入）
• 退货：购物车中的商品列表。

clearCart

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

• 输入: {} （无需输入）
• 退货：确认消息。

故障排除

• 登录失败：确保您的电子邮件和密码 .env 是正确的。
• 会话错误：如果工具返回身份验证错误，请运行 npm run login 刷新您的会话Cookie。
• 构建错误：确保所有依赖项都已安装 npm install.

许可证

该项目根据ISC许可证获得许可。