AI导哈

电商AI集成服务

Saleor MCP Server是一个为Saleor电商平台提供的模型上下文协议服务器，支持与AI助手和工具集成，用于读取产品、客户和订单数据。

  • by saleor
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 saleor/saleor-mcp

使用说明

销售MCP服务器

Saleor Commerce的模型上下文协议（MCP）服务器，提供与AI助手和工具的集成。

入门指南

Saleor MCP服务器允许AI助手与Saleor实例交互，以获取有关产品、客户和订单的数据。MCP是只读的-它不会触发Saleor API的任何突变。

尝试Saleor MCP服务器的最简单方法是访问部署在以下位置的生产实例：

https://mcp.saleor.app/

您可以使用Streamable HTTP连接到服务器，网址为 https://mcp.saleor.app/mcp 终点。有关所需标头的详细信息，请参阅下面的配置部分。生产实例已配置为连接到托管在上的Saleor实例 saleor.cloud 域名，与Saleor 3.22兼容。

安装

以下说明将帮助您在本地设置Saleor MCP服务器，以便进行开发和测试。

先决条件

  • Python 3.12或更高版本
  • 紫外线 包管理器

设置

  1. 克隆仓库

    git clone git@github.com:saleor/saleor-mcp.git
cd saleor-mcp

  2. 安装依赖项

    uv sync

  3. 在本地运行MCP服务器

    uv run saleor-mcp

    服务器将于启动 http://localhost:6000

配置

X-Saleor-API-URL 和 X-Saleor-Auth-Token 标头

Saleor MCP服务器使用两个头来配置与Saleor API的连接：

  • X-Saleor-API-URL -Saleor API终结点的URL。
  • X-Saleor-Auth-Token -用于访问Saleor API的身份验证令牌。令牌必须具有 MANAGE_PRODUCTS 和 MANAGE_ORDERS 访问可用工具的权限。

请确保在向MCP服务器发出的请求中包含这些标头。

ALLOWED_DOMAIN_PATTERN env变量

这 ALLOWED_DOMAIN_PATTERN 环境变量用于为MCP服务器可以连接到的允许的API域指定regex模式。设置后，服务器将验证 X-Saleor-API-URL 与此模式相反。如果未设置，则允许使用任何域。Patten必须包括特殊角色的转义。

例子： https:\/\/.*\.saleor\.cloud\/graphql\/ -允许任何子域 saleor.cloud 和那个 /graphql/ 路径。

与AI助手集成

Saleor MCP可以在AI助手中启用，这些助手支持使用Streamable HTTP和设置适当的标头与自定义MCP服务器集成。

以下是VSCode/Copilot的示例配置，使用 mcp.json 文件：

{
  "servers": {
    "saleor-mcp": {
      "type": "http",
      "url": "https://mcp.saleor.app/mcp",
      "headers": {
        "X-Saleor-Auth-Token": "eyJhb...",
        "X-Saleor-API-URL": "https://example.saleor.cloud/graphql/"
      }
    }
  }
}

发展

此项目使用 阿里阿德涅密码子 以从GraphQL模式生成Saleor API客户端代码。看 pyproject.toml 用于配置。 要在本地重新生成客户端，请运行：

ariadne-codegen

相关 MCP