关键词

AI语音代理电话呼叫语音外呼LLM集成语音助手

使用说明

项目简介

QuickVoice MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在连接大型语言模型 (LLM) 客户端和 QuickVoice AI 语音代理平台。它允许 LLM 通过标准的 MCP 协议，利用 QuickVoice 的 AI 语音代理发起电话呼叫。

主要功能点

  • 发起呼叫工具 (Initiate Call Tool)：提供 'initiate_call' 工具，允许 LLM 客户端指示 QuickVoice 语音代理拨打电话，并可指定呼叫的上下文信息和指令。
  • 呼叫 Prompt 模板 (Outbound Call Prompt)：提供 'make_outbound_call' Prompt 模板，帮助 LLM 客户端生成用于发起呼叫的指令。
  • 灵活配置：支持通过环境变量配置 QuickVoice API 凭据和 API Endpoint。
  • Docker 部署：提供 Docker 镜像，方便用户快速部署和运行 MCP 服务器。

安装步骤

Docker 方式 (推荐)

  1. 拉取 Docker 镜像： 
    docker pull rexanity/quickvoice-mcp
  2. 运行 Docker 容器 (需要替换 'your-agent-id' 和 'your-api-key' 为您的 QuickVoice API 凭据)： 
    docker run -e QUICKVOICE_AGENT_ID="your-agent-id" -e QUICKVOICE_API_KEY="your-api-key" rexanity/quickvoice-mcp

Pip 方式

  1. 从 GitHub 仓库安装： 
    pip install git+https://github.com/rexanity/quickvoice_mcp.git
  2. 运行服务器： 
    python -m src.server

服务器配置

对于 Claude Desktop 或其他 MCP 客户端，您需要配置 MCP 服务器连接信息。以下是 Claude Desktop 的配置示例，您需要将此 JSON 配置添加到 Claude Desktop 的配置文件 ('claude_desktop_config.json') 中。

{
  "mcpServers": {
    "QuickVoice": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "QUICKVOICE_AGENT_ID=your-agent-id",  // 替换为您的 QuickVoice Agent ID
        "-e",
        "QUICKVOICE_API_KEY=your-api-key",    // 替换为您的 QuickVoice API Key
        "rexanity/quickvoice-mcp"
      ]
    }
  }
}

注意：请务必将 'your-agent-id' 和 'your-api-key' 替换为您的 QuickVoice API 凭据。这些凭据用于 QuickVoice MCP Server 连接到 QuickVoice 服务。

基本使用方法

  1. 确保 QuickVoice MCP Server 已经成功安装并运行。
  2. 在您的 MCP 客户端（例如 Claude Desktop）中配置 QuickVoice MCP Server 连接。
  3. 在 MCP 客户端中，您可以使用自然语言提示来指示进行电话呼叫。例如，在 Claude Desktop 中，您可以输入类似 “Call 555-123-4567 and schedule an appointment” 的指令。
  4. MCP 客户端会调用 QuickVoice MCP Server 提供的工具和 Prompt，从而通过 QuickVoice AI 语音代理发起电话呼叫。

关键词

AI语音代理, 电话呼叫, 语音外呼, LLM集成, 语音助手

信息

分类

AI与计算

访问项目