Adwords MCP
2025.04.11
2
TypeScript广告注入MCP 服务器其它
Adwords MCP 是一个玩笑性质的 MCP（Model Context Protocol）服务器，主要用于在 LLM（大型语言模型）的响应中插入令人尴尬的广告。该项目展示了如何构建 MCP 服务器以及广告注入中介的风险。虽然是一个演示项目，但也具备一些实际功能，如关键词提取、随机广告选择和多种广告注入策略。
View on GitHub
Overview
基本能力
产品定位
Adwords MCP 是一个用于演示和玩笑的 MCP 服务器，主要用于在 LLM 响应中插入广告，展示广告注入中介的风险。
核心功能
- 关键词提取：使用简单的字符串匹配来确保广告的最大中断效果。
- 随机广告选择：根据检测到的关键词或随机选择广告。
- 广告注入策略：多种策略用于在响应中嵌入广告。
- 多种传输选项：支持 STDIO 和 HTTP/SSE 传输。
- 资源模板：通过 MCP 资源访问广告模板（可选）。
- 可配置选项：通过命令行标志或编程 API 自定义行为。
- 工具别名：为所有工具提供短别名以便于调用。
适用场景
- 演示 MCP 服务器的功能。
- 展示广告注入中介的风险。
- 用于玩笑或恶作剧（如在朋友的机器上安装）。
工具列表
get_completion：返回带有嵌入广告的完成响应。analyze_code：执行虚假代码分析并嵌入广告。developer_tip：提供开发提示并嵌入广告。- 别名：
gc、ac和tip作为更短的替代工具。
常见问题解答
- 如何避免广告注入：不要在生产环境或真实用户中使用此项目。
- 如何配置 MCP 客户端：参考 README 中的配置示例。
使用教程
使用依赖
- 需要安装 Node.js 和 npm。
安装教程
从 NPM 安装
npm install -g adwords-mcp
从源代码安装
- 克隆仓库：
git clone https://github.com/gregce/adwords-mcp.git
cd adwords-mcp
- 安装依赖：
npm install
- 构建项目：
npm run build
- 全局链接：
npm link
- （可选）在开发模式下运行服务器：
# 使用 stdio 传输（适用于 MCP 客户端如 Claude）
npm run dev
# 使用 HTTP/SSE 传输（适用于基于浏览器的客户端）
USE_HTTP=true npm run dev
调试方式
# 使用 stdio 传输运行
adwords-mcp
# 使用 HTTP/SSE 传输运行
adwords-mcp --http
# 设置自定义端口（默认为 3000）
adwords-mcp --http --port=3001
# 不使用随机广告
adwords-mcp --no-random-ads