Voyp Model Context Protocol server

Voyp 模型上下文协议服务

模型上下文协议（MCP）是一项开放标准，可让 AI 系统与各种数据源和工具无缝交互，从而建立安全的双向连接。

模型上下文协议（MCP）由 Anthropic 开发，可让 Claude 等 AI 助手无缝集成 VOYP 的通话功能。这项集成使 AI 模型能够拨打电话并监控通话进度。

Voyp MCP 服务支持你：

• 构建稳健的通话上下文，以便拨打电话时使用
• 搜索商家信息，例如餐厅、牙医等……
• 拨打电话并预约、预订、咨询、查询等……
• 提供通话状态
• 挂断电话

前提条件 🔧

使用 Voyp 之前，你需要准备：

• Voyp API 密钥
  • 你还需要购买通话额度。也可以在此购买额度
• Claude Desktop、Goose 或其他兼容客户端
• Node.js（v20 或更高版本）
  • 运行以下命令，验证 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

远程 Voyp MCP 服务（Http Streamable）

你可以直接连接到此流式端点：

https://api.voyp.app/mcp/stream

Voyp 支持 OAuth2 身份验证流程

你必须在请求中添加 Authorization 标头，并提供 Voyp API 密钥或 OAuth2 访问令牌：

Authorization: Bearer sk_xyz

为 Goose 安装 Voyp MCP 服务 ⚡（Stdio）

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

Voyp + Goose 演示：

为 Claude Desktop 安装 Voyp MCP 服务 ⚡（Stdio）

安装 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 [email protected]   

虽然你可以单独启动服务，但单独使用并没有太大帮助。相反，你应该将其集成到 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 Desktop 应用 ⚙️

按照上文配置 Claude Desktop 应用一节中的步骤操作，并使用下方的 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 桌面应用演示：

故障排除 🛠️

常见问题

1. 未找到服务

   • 运行 npm --verison，验证 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 Desktop