Iab Deals MCP Server

IAB交易MCP服务器

MCP服务器实现IAB Deals API v1.0，用于程序化交易管理。

概述

此MCP服务器提供用于管理以下程序化广告交易的工具 IAB交易API规范它使AI代理能够创建、管理和监控DSP和SSP之间的交易。

特性

• 9 MCP工具 实现完整的交易生命周期管理
• 模拟提供者 用于独立演示（无外部依赖）
• SQLite数据库 为了本地持久性
• 符合IAB标准 数据模型和状态代码
• 可扩展 用于真正DSP/SSP集成的提供商架构

快速开始

安装

# Clone the repository
git clone https://github.com/Hypermindz-AI/iab-deals-mcp-server.git
cd iab-deals-mcp-server

# Install dependencies
npm install

# Copy environment file
cp .env.example .env

# Build
npm run build

# Run
npm start

Claude桌面配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "iab-deals": {
      "command": "node",
      "args": ["/path/to/iab-deals-mcp-server/dist/index.js"],
      "env": {
        "NODE_ENV": "demo",
        "SEED_DEMO_DATA": "true"
      }
    }
  }
}

或与 npx （出版后）：

{
  "mcpServers": {
    "iab-deals": {
      "command": "npx",
      "args": ["iab-deals-mcp"],
      "env": {
        "NODE_ENV": "demo"
      }
    }
  }
}

MCP工具

演示演练

1.列出现有交易

Use the deals/list tool to see sample deals

2.创建新交易

Use deals/create with:
- name: "Q2 Video Campaign"
- origin: "ads.mybrand.com"
- seller: "My Brand Inc"
- adTypes: [2] (Video)
- dealFloor: 25.00
- startDate: "2026-04-01T00:00:00Z"

3.发送给提供商

Use deals/send with:
- dealId: 
- providerId: "mock"
- seatId: "buyer-seat-001"

4.检查状态

Use deals/status with the dealId

5.确认交易

Use deals/confirm with the dealId

6.暂停/恢复

Use deals/pause and deals/resume to control delivery

数据模型

交易状态代码（卖方）

买方状态代码

广告类型

项目结构

iab-deals-mcp-server/
├── src/
│   ├── index.ts           # MCP server entry point
│   ├── config.ts          # Configuration management
│   ├── models/            # Zod schemas and types
│   │   ├── deal.ts
│   │   ├── terms.ts
│   │   ├── inventory.ts
│   │   ├── buyer-seat.ts
│   │   └── provider.ts
│   ├── tools/             # MCP tool implementations
│   │   └── index.ts
│   ├── providers/         # DSP/SSP provider abstraction
│   │   ├── base.ts
│   │   ├── mock.ts
│   │   └── registry.ts
│   └── db/                # Database layer
│       ├── schema.ts
│       ├── database.ts
│       └── seed.ts
├── package.json
├── tsconfig.json
└── README.md

认证

MCP服务器（客户端→ 服务器）

• 示范模式：不需要身份验证
• 生产：设置 IAB_DEALS_API_KEY 环境变量

提供者API（服务器→ DSP/SSP）

在环境变量中配置提供程序凭据：

# The Trade Desk
TTD_API_KEY=your-api-key
TTD_PARTNER_ID=your-partner-id

# Google DV360
DV360_SERVICE_ACCOUNT_JSON={"type":"service_account",...}

# FreeWheel
FREEWHEEL_CLIENT_ID=your-client-id
FREEWHEEL_CLIENT_SECRET=your-client-secret

发展

# Development mode with hot reload
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint

# Run tests
npm test

添加新提供者

1. 在中创建新文件 src/providers/ （例如。， ttd.ts)
2. 实施 DealProvider 接口
3. 注册于 src/providers/registry.ts

例子：

import { BaseDealProvider } from "./base.js";
import type { Deal, BuyerSeat, ProviderResponse } from "../models/index.js";

export class TradeDeskProvider extends BaseDealProvider {
  readonly id = "ttd";
  readonly name = "The Trade Desk";

  isAvailable(): boolean {
    return !!process.env.TTD_API_KEY;
  }

  async sendDeal(deal: Deal, seatId: string): Promise
 {
    // Implement TTD API integration
  }

  // ... other methods
}

许可证

MIT许可证-请参阅 许可证 了解详情。

贡献

这是IAB技术实验室代理工作组的参考实现。欢迎投稿！

资源

• IAB交易API规范
• 模型上下文协议（MCP）
• IAB技术实验室

______________________________________________________________________

建造于 HyperMindZ IAB技术实验室代理工作组。