Amazon Ads Manager MCP 服务器

一个用于管理和分析 Amazon 广告数据的模型上下文协议 (MCP) 服务器。此服务器为 LLM 提供了一个标准化的接口，以便通过 Claude Desktop App 与您的广告数据进行交互。

功能

• 数据库集成: 预配置了与安全 PostgreSQL 数据库的连接
• API 密钥认证: 通过 API 密钥验证实现安全访问
• 实时分析: 访问广告活动指标和效果数据
• 自然语言界面: 使用自然语言查询您的广告数据

安装

npm install ads-manager-mcp

快速开始

1. 安装 Claude Desktop App
2. 创建一个配置文件 claude-desktop-config.json:

{
  "name": "Amazon Ads Manager",
  "version": "1.0.4",
  "description": "连接到您的 Amazon 广告数据并分析广告活动效果",
  "mcpServers": {
    "ads-manager": {
      "name": "Ads Manager MCP Server",
      "version": "1.0.4",
      "description": "用于 Amazon 广告数据分析的 MCP 服务器",
      "transport": "sse",
      "endpoint": "https://mcp-server-sync-abhilashreddi.replit.app/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

3. 将 YOUR_API_KEY_HERE 替换为您的 API 密钥
4. 开始使用 Claude Desktop App 分析您的广告数据

可用资源

• Schema: 查看数据库结构和表定义
• Metrics: 访问广告效果指标
• Campaigns: 查看广告活动配置和设置
• Ad Groups: 访问广告组详细信息和设置

可用工具

• analyzeCampaignPerformance: 分析广告活动指标和效果
• analyzeAdGroupPerformance: 获取详细的广告组效果分析
• optimizeBudget: 获取预算优化建议
• query: 针对数据库运行自定义 SQL 查询

示例查询

"Show me the structure of all tables in the database"
"Analyze the performance of campaign ABC123 for the last 30 days"
"What are the key metrics for ad group XYZ789?"
"Give me budget recommendations for all campaigns in profile P123"

API 认证

服务器使用 API 密钥认证。每个请求必须包含一个 Authorization 标头：

Authorization: Bearer YOUR_API_KEY

数据库连接

服务器维护与 PostgreSQL 数据库的连接。无需额外配置，因为连接详细信息已在软件包中预先配置。

开发

要在本地运行服务器：

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建软件包
npm run build

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

支持

如需支持，请在 GitHub 仓库中打开一个 issue 或联系维护人员。