使用说明（Markdown 格式）

• 项目简介

  • AdCP Sales Agent MCP 服务器是一个基于 MCP（模型上下文协议）的后端服务，设计目标是以统一的接口向 AI 客户端提供上下文信息、资源、工具以及可定制的 Prompt 模板，便于 LLM 进行资源检索、外部功能调用和对话交互。
  • 服务器核心通过 JSON-RPC 与客户端通信，提供包括资源管理、工具注册与执行、以及 Prompts 的渲染与管理等能力，支持多种传输协议并具备会话和权限管理能力，适用于多租户场景的后端上下文服务。

• 主要功能点

  • MCP 请求/响应处理：实现基于 FastMCP 的 HTTP/SSE 传输，按 MCP 规范接收请求并返回 JSON-RPC 响应。
  • 资源管理与数据访问：托管并管理资源（Resources），提供统一的数据访问能力。
  • Tools 注册与执行：注册并执行 Tools，LLM 可以通过 MCP 调用外部功能进行任务执行。
  • Prompt 模板管理与渲染：定义、渲染与管理 Prompts，支持自定义对话模式。
  • 会话与多租户管理：支持多租户隔离、会话管理、安全审计与权限控制。
  • Admin 界面与集成适配器：提供 Admin UI、GAM 等广告服务器的适配器集成，以及 A2A（Agent-to-Agent）接口。
  • 测试、开发与部署工具：包含单元/集成测试、开发指南与多种部署方案（Docker、云端等）。

• 安装与运行步骤

  • 获取代码：将仓库克隆到本地开发环境。
  • 依赖安装：使用项目提供的依赖配置文件进行依赖安装（Python 3.12+ 环境，Lens/数据库驱动等）。
  • 数据库准备：根据配置准备 PostgreSQL 数据库（仓库给出多租户/多场景的数据结构示例）。
  • 启动服务器：按照仓库提供的部署方案启动 MCP 服务器进程，通常通过容器或直接运行服务器入口脚本启动。
  • MCP 客户端对接：MCP 客户端需要的配置信息包括服务器地址、认证令牌等，以及启动命令与参数以与 MCP 服务器建立连接。

• 服务器配置（MCP 客户端对接所需信息，JSON 格式） 服务器名称: AdCP Sales Agent MCP Server 启动命令与参数示例（用于 MCP 客户端配置读取，不需要在代码中展示，仅提供描述） { "server_name": "AdCP Sales Agent MCP Server", "command": "uvx", "args": ["mcp-remote", "http://localhost:8000/mcp/", "--header", "x-adcp-auth: YOUR_TOKEN"], "description": "启动 MCP 服务的命令及必要参数，需在客户端配置中提供，用于客户端连接到 MCP 服务器的地址、鉴权方式以及传输选项。该配置仅供 MCP 客户端使用，客户端实现细节不在 MCP 服务端暴露。" }

• 基本使用方法

  • 运行环境准备：确保已安装 Python 3.12+、Docker 和 PostgreSQL（如仓库快速启动文档所述）。
  • 启动服务：按照项目中的部署文档，使用 Docker Compose 或本地部署方式启动 MCP 服务器、Admin UI 和 A2A 服务。
  • 连接与交互：MCP 客户端通过 JSON-RPC 调用工具、资源和 Prompts 的接口，与服务器进行交互（如读取资源、调用工具、获取 Prompt）。
  • 安全与扩展性：服务器实现了会话管理和权限声明，支持多协议传输（如 Stdio、SSE、WebSocket），便于在不同环境下安全、可扩展地提供上下文服务。