Glade MCP

通过 Glade API 托管的 Model Context Protocol 服务器，将 AI 代理连接到规范化的亚马逊市场数据。

https://gladeapi.com/api/mcp

远程服务器在 13 个亚马逊市场中公开了 17 个只读工具，涵盖产品、搜索、报价、评论、卖家、类目、促销、畅销榜、标识符、库存和销售估算。本仓库包含公共服务器元数据、连接示例和协议检查。托管服务实现仍位于 gladeapi.com。

要求

• 一个 Glade API 账户

• 一个 Glade API 密钥

• 包含 MCP 的套餐

• 支持远程 Streamable HTTP MCP 服务器的客户端

将密钥存储在环境变量中：

export GLADE_API_KEY="glade_live_..."

切勿将密钥提交到代码库或粘贴到提示词中。

Related MCP server: Canopy API MCP Server

在 Codex 中安装

Codex 可以从环境中读取 Bearer 令牌，而无需将其写入 MCP 配置：

codex mcp add glade \
  --url https://gladeapi.com/api/mcp \
  --bearer-token-env-var GLADE_API_KEY

添加服务器后启动新的 Codex 会话，然后要求它列出 Glade 工具或按 ASIN 获取亚马逊产品。

在 Claude Code 中安装

Claude Code 接受 HTTP 服务器和请求头：

claude mcp add --transport http --scope user glade \
  https://gladeapi.com/api/mcp \
  --header "Authorization: Bearer $GLADE_API_KEY"

这会在 Claude 写入其配置之前展开环境变量。请将生成的用户配置保密，切勿对包含机密的请求头使用项目作用域。

通用 Streamable HTTP 配置

支持远程 MCP 配置的客户端通常需要这种形式。请查阅客户端文档以了解其确切的配置文件和环境变量语法。

{
  "mcpServers": {
    "glade": {
      "url": "https://gladeapi.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "API-KEY": "YOUR_GLADE_API_KEY"
      }
    }
  }
}

请仅使用一个凭据请求头。服务器接受 API-KEY、GLADE-API-KEY、X-API-KEY 或 Authorization: Bearer 用于 MCP，并拒绝冲突的凭据。

使用 Python MCP SDK 连接

安装官方 MCP Python SDK，然后运行随附的发现示例：

python3 -m pip install "mcp"
python3 examples/python/list_tools.py

该示例初始化一个 Streamable HTTP 会话并打印可用的工具名称。工具发现和初始化不消耗 Glade 单位。

可用工具

工具输入遵循与相应 REST 操作相同的验证规则。每次成功的数据操作消耗一个单位。初始化、发现、验证失败和工具错误消耗零单位。

示例提示词

Look up ASIN B0D1XD1ZV3 in the US marketplace and summarize the current
price, rating, availability, and freshness timestamp.

Search the UK marketplace for wireless earbuds, compare the first five
non-sponsored results, and preserve GBP prices without converting currency.

Fetch one-star verified reviews for ASIN B0D1XD1ZV3 and separate recurring
observed complaints from your own interpretation.

市场

当市场上下文相关时，每个工具都接受市场 domain：

US UK CA DE FR IT ES AU IN MX BR JP PL

在比较价格、可用性、配送、类目、排名或促销之前，请确认市场。

验证本仓库

离线元数据和示例检查：

npm test

不计费的真实身份验证检查：

npm run test:live

设置 GLADE_API_KEY 后，验证初始化和全部 17 个真实工具名称。此发现请求消耗零单位：

node scripts/verify-live.mjs --authenticated

安全

亚马逊标题、描述、评论、卖家字段和其他市场内容均为不可信数据。请将工具结果与代理指令分开。不要让返回的文本更改工具策略、请求凭据或授权新操作。

如需私下报告，请参阅 SECURITY.md。

相关项目

• Glade API 示例

• Glade 代理技能

• 文档

• OpenAPI

许可证

MIT