亚马逊联盟MCP服务器

一个模型上下文协议(MCP)服务器,允许AI助手(如Claude、GitHub Copilot等)推荐亚马逊产品并自动嵌入联盟标签。

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

使用说明

亚马逊联盟MCP服务器

结束 模型上下文协议(MCP)服务器它允许人工智能助手(Claude,GitHub Copilot等)推荐亚马逊产品,并自动构建您的联盟标签。


MCP是做什么的?

人工智能助理将获得8个专业工具:

工具 描述
amazon_search 使用联盟链接和可选价格过滤器进行产品搜索
amazon_product_link 通过ASIN直接链接与Affiliate标签
amazon_deals 最新优惠, 闪电优惠, Outlet, 仓库
amazon_bestsellers 畅销书听我说
amazon_gift_finder 具有预算过滤器的个性化礼品创意
amazon_compare 产品比较(2-5 ASINs)与联盟链接
amazon_promo_content Twitter,Instagram,Blog,WhatsApp,Telegram,Newsletter的广告文本
amazon_affiliate_info 佣金信息和提高收入的提示

条件

  • Node.js ≥ 18
  • 亚马逊合作伙伴计划帐户(mazon.de附属计划)
  • 您的联盟标签(当前配置: addonsdeaddonssh)

重要 : 亚马逊联盟标签以结尾 .de 通常在 -21 (z.B。 meintag-21).
确保你的一天在你的 PartnerNet 帐户 已存放。


安装

cd ~/amazon-affiliate-mcp
npm install
npm run build

在自己的服务器上自主托管(例如:www.add-ons.de)

是的,您可以在自己的域名下的服务器上运行此 MCP。

重要:在普通VPS上,您需要明确启用HTTP模式。

1)在服务器上构建

cd /opt/amazon-affiliate-mcp
npm ci
npm run build

2) 建立系统服务

文件 : /etc/systemd/system/amazon-affiliate-mcp.service

[Unit]
Description=Amazon Affiliate MCP HTTP Server
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/amazon-affiliate-mcp
Environment=NODE_ENV=production
Environment=MCP_MODE=http
Environment=PORT=3000
Environment=AMAZON_DEFAULT_COUNTRY=de
Environment=AMAZON_AFFILIATE_TAG_DE=deintag-21
Environment=AMAZON_AFFILIATE_TAG=deintag-21
ExecStart=/usr/bin/node dist/index.js
Restart=always
RestartSec=5
User=www-data
Group=www-data

[Install]
WantedBy=multi-user.target

开始服务 :

sudo systemctl daemon-reload
sudo systemctl enable --now amazon-affiliate-mcp
sudo systemctl status amazon-affiliate-mcp

3) Nginx作为www.add-ons.de的反向代理

文件 : /etc/nginx/sites-available/www.add-ons.de

server {
  listen 80;
  server_name www.add-ons.de;

  location /mcp {
    proxy_pass http://127.0.0.1:3000/mcp;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }

  location /health {
    proxy_pass http://127.0.0.1:3000/health;
    proxy_set_header Host $host;
  }

  location /.well-known/mcp/server-card.json {
    proxy_pass http://127.0.0.1:3000/.well-known/mcp/server-card.json;
    proxy_set_header Host $host;
  }

  location /icon.svg {
    proxy_pass http://127.0.0.1:3000/icon.svg;
    proxy_set_header Host $host;
  }
}

激活 :

sudo ln -s /etc/nginx/sites-available/www.add-ons.de /etc/nginx/sites-enabled/www.add-ons.de
sudo nginx -t
sudo systemctl reload nginx

TLS证书(Let's Encrypt)

sudo certbot --nginx -d www.add-ons.de

5)功能测试

curl -i https://www.add-ons.de/health
curl -i https://www.add-ons.de/.well-known/mcp/server-card.json

如果两者都回答200,则您的MCP可以通过以下方式公开访问:

  • https://www.add-ons.de/mcp
  • https://www.add-ons.de/.well-known/mcp/server-card.json

注意:如果您没有root域名 www 如果你想使用, 添加到Nginx add-ons.de 我是 server_name 在证书中。


集成到 Claude Desktop

本地(stdio模式)

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amazon-affiliate": {
      "command": "node",
      "args": ["/Users/DEIN_BENUTZERNAME/amazon-affiliate-mcp/dist/index.js"],
      "env": {
        "AMAZON_AFFILIATE_TAG": "addonsdeaddonssh"
      }
    }
  }
}

替换 DEIN_BENUTZERNAME 您的 macOS 用户名 (whoami im终端)。

HTTP远程(www.add-ons.de)

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amazon-affiliate": {
      "url": "https://www.add-ons.de/mcp"
    }
  }
}

您也可以将此路径用于其他 MCP 客户端(GitHub Copilot、VSCode 等)。


在 VS Code / GitHub Copilot 中集成

创建或编辑 .vscode/mcp.json im工作区:

{
  "servers": {
    "amazon-affiliate": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/DEIN_BENUTZERNAME/amazon-affiliate-mcp/dist/index.js"],
      "env": {
        "AMAZON_AFFILIATE_TAG": "addonsdeaddonssh"
      }
    }
  }
}

环境变量

变量 标准 描述
AMAZON_AFFILIATE_TAG addonsdeaddonssh Dein联盟标签
AMAZON_BASE_URL https://www.amazon.de 亚马逊域名(z.B。 .com 美国) 。

AI中的示例使用

用户 : “推荐100欧元以下的蓝牙耳机。"

使用 KI amazon_search:

  • 查询: Bluetooth Kopfhörer
  • 类别: elektronik
  • 价格_最大值: 100

KI回答:
https://www.amazon.de/s?k=Bluetooth+Kopfhörer&tag=addonsdeaddonssh&i=electronics&high-price=100

通过此链接进行的每次购买=为您提供佣金。


可用类别

elektronik, computer, bücher, mode, garten, spielzeug, sport, küche, beauty, software, musik, filme, lebensmittel, auto, baby, gesundheit, bürobedarf, haustier, schmuck


法律声明

根据德国法律和亚马逊使用条款 必须 在Affiliate链接中,请注意:

“作为亚马逊的合作伙伴,我通过合格的购买赚钱。你不会有额外的费用。"

这 amazon_promo_content工具会自动将此提示插入到所有生成的文本中。


发展

# Direkt starten (ohne Build)
npm run dev

# Build
npm run build

# Produktiv starten
npm start

许可证

麻省理工学院