HACKATHON MCP

优步外部广告API MCP服务器

一个MCP（模型上下文协议）服务器，提供对优步外部广告API的访问，用于活动管理。

特性

• 获取活动：使用可选筛选检索广告帐户的活动
• 获取活动：获取特定活动的详细信息
• 创建市场活动：创建新的广告活动
• 更新活动：修改现有活动
• 删除活动：删除活动

安装

npm install
npm run build

用法

发展

npm run dev

生产

npm start

可用工具

get_campaigns

检索广告帐户的活动。

参数：

• auth_token （必填）：用于身份验证的承载令牌
• ad_account_id （必填）：广告帐户UUID
• filters （可选）：具有过滤选项的对象

- status：按活动状态筛选（活动、暂停、已删除） - limit：要返回的活动数（1-100，默认值：20） - offset：要跳过的活动数（默认值：0）

get_campaign

获取特定活动的详细信息。

参数：

• auth_token （必填）：用于身份验证的承载令牌
• ad_account_id （必填）：广告帐户UUID
• campaign_id （必填）：活动UUID

create_campaign

创建新活动。

参数：

• auth_token （必填）：用于身份验证的承载令牌
• ad_account_id （必填）：广告帐户UUID
• campaign_data （必填）：活动配置对象

- name （必填）：活动名称 - budget_amount （必填）：预算金额（美元） - status：活动状态（活动、暂停）-默认值：活动 - budget_type：预算类型（每日、终身）-默认值：每日 - start_time：活动开始时间（ISO 8601） - end_time：活动结束时间（ISO 8601） - objective：活动目标（意识、考虑、转化）-默认值：转化

update_campaign

更新现有活动。

参数：

• auth_token （必填）：用于身份验证的承载令牌
• ad_account_id （必填）：广告帐户UUID
• campaign_id （必填）：活动UUID
• campaign_data （必填）：要应用更新

- name：活动名称 - status：活动状态（活动、暂停） - budget_amount：预算金额（美元） - end_time：活动结束时间（ISO 8601）

delete_campaign

删除活动。

参数：

• auth_token （必填）：用于身份验证的承载令牌
• ad_account_id （必填）：广告帐户UUID
• campaign_id （必填）：活动UUID

示例用法

以提供的curl请求为例：

// Get campaigns
await callTool('get_campaigns', {
  auth_token: 'IA.AQAAAATlHYAkrhJsBvg2h_K7dmXYDF_9LQAe8gEiCkd7Wyd79AB36AmskjmnMMPtDOwrWBgnGuHNb0Esrh2dScncw8weNgx5kjMNtxP88XJSdDzjfdOmcWe3Zvc0rHx-p5ldHqmXvDvUnjndiPqXigz_yg332ek6b_dmR-1KRus',
  ad_account_id: 'd924b89c-09f9-477b-a3ae-5526aa533835',
  filters: {
    status: 'ACTIVE',
    limit: 10
  }
});

配置

服务器使用优步外部广告API基础URL： https://api.uber.com/v1/ads

所有请求都需要有效的Bearer令牌进行身份验证。

错误处理

服务器为以下对象提供详细的错误消息：

• 身份验证失败
• 无效参数
• API错误
• 网络问题

错误将返回 isError: true 以及描述性信息。

安全

• 所有身份验证令牌均已验证
• 使用Zod模式验证输入参数
• API响应已正确格式化和消毒