Voyp 模型上下文协议服务器

模型上下文协议（MCP）是一个开放标准，它使 AI 系统能够与各种数据源和工具无缝交互，促进安全的双向连接。

由 Anthropic 开发的模型上下文协议（MCP）使得像 Claude 这样的 AI 助手能够无缝集成 VOYP 的呼叫功能。这种集成提供了让 AI 模型进行电话呼叫并监控其进度的可能性。

Voyp MCP 服务器允许您：

• 构建强大的呼叫上下文以在拨打电话时使用
• 在拨打餐馆、牙医等电话时搜索商业信息
• 打电话预约、预订、咨询、询问等
• 提供通话状态
• 挂断电话

先决条件 🔧

在使用 Voyp 之前，您需要：

• Voyp API 密钥
  • 您还需要购买用于拨打电话的信用点数。您也可以在这里购买信用点数：这里
• Claude Desktop, Goose 或其他兼容客户端
• Node.js (版本 20 或更高)
  • 您可以通过运行以下命令来验证您的 Node.js 安装：
    • node --version
• 安装 Git（仅当使用 Git 安装方法时需要）
  • 在 macOS 上: brew install git
  • 在 Linux 上:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • 在 Windows 上: 下载 Git for Windows

为 Goose 安装 Voyp MCP 服务器 ⚡

要安装 voyp-mcp 服务器，您需要手动添加扩展。

Voyp + Goose 演示：

为 Claude Desktop 安装 Voyp MCP 服务器 ⚡

要安装 voyp-mcp 服务器，您可以使用以下方法之一：

1. 通过 Smithery 安装
2. 使用 NPX 运行
3. Git 安装

1. 通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Voyp 模型上下文协议服务器:

npx -y @smithery/cli install @paulotaylor/voyp-mcp --client claude

2. 使用 NPX 运行

npx -y voyp-mcp@0.1.0   

虽然您可以独立启动一个服务器，但这单独使用并不特别有用。相反，您应该将其集成到 MCP 客户端中。下面是如何配置 Claude Desktop 应用程序以与 voyp-mcp 服务器一起工作的示例。

配置 Claude Desktop 应用程序 ⚙️

对于 macOS:

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

对于 Windows:

code %APPDATA%\Claude\claude_desktop_config.json

添加 Voyp 服务器配置：

将 your-VOYP-api-key 替换为您实际的 VOYP API 密钥。

{
  "mcpServers": {
    "voyp-mcp": {
      "command": "npx",
      "args": ["-y", "voyp-mcp"],
      "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
      }
    }
  }
}

3. Git 安装

1. 克隆仓库：

git clone https://github.com/paulotaylor/voyp-mcp.git
cd voyp-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置 Claude 桌面应用程序 ⚙️

请按照上述配置 Claude 桌面应用程序部分中概述的配置步骤进行操作，使用下面的 JSON 配置。

将 your-VOYP-api-key-here 替换为您的实际 VOYP API 密钥，并将 /path/to/voyp-mcp 替换为您在系统上克隆仓库的实际路径。

{
  "mcpServers": {
    "voyp": {
      "command": "npx",
      "args": ["/path/to/voyp-mcp/build/index.js"],
      "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
      }
    }
  }
}

在 Claude 桌面应用中的使用 🎯

安装完成后，并且已经配置好 Claude 桌面应用程序后，您必须完全关闭并重新打开 Claude 桌面应用程序才能看到 voyp-mcp 服务器。您应该会在应用程序左下角看到一个锤子图标，这表示可用的 MCP 工具，您可以点击锤子图标以查看有关 start_call 和 hangup_call 工具的更多详情。

现在 Claude 将能够完全访问 voyp-mcp 服务器，包括 start_call 和 hangup_call 工具。

Voyp + Claude Desktop 演示：

故障排除 🛠️

常见问题

1. 找不到服务器

   • 通过运行 npm --version 来验证 npm 安装
   • 通过运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json 来检查 Claude 桌面应用程序配置语法
   • 通过运行 node --version 确保 Node.js 正确安装

2. 与 NPX 相关的问题

• 如果遇到与 npx 相关的错误，您可能需要改用 npx 可执行文件的完整路径。
• 可以通过在终端中运行 which npx 来找到此路径，然后在配置中将 "command": "npx" 行替换为 "command": "/full/path/to/npx"。

3. API 密钥问题
   • 确认您的 VOYP API 密钥有效
   • 检查 API 密钥是否已在配置中正确设置
   • 确认 API 密钥周围没有空格或引号

致谢 ✨

• Model Context Protocol 提供了 MCP 规范
• Anthropic 提供了 Claude 桌面应用程序