voyp-mcp

🚀 Voyp 模型上下文协议服务器

模型上下文协议 (MCP) 是一个开放标准，它能让人工智能系统与各类数据源和工具实现无缝交互，达成安全的双向连接。由 Anthropic 开发的该协议，可使像 Claude 这样的 AI 助手与 VOYP 的通话功能完美集成，赋予 AI 模型拨打电话、监控通话进展等能力。Voyp MCP 服务器则为用户提供了构建强大通话上下文、搜索商家信息、拨打与安排预约等一系列实用功能。

🚀 快速开始

Voyp MCP 服务器允许您：

• 构建强大的通话上下文用于拨打时使用
• 搜索餐厅、牙医等商家信息
• 拨打并安排预约、预订、咨询等
• 提供通话状态
• 结束通话

✨ 主要特性

• 模型上下文协议 (MCP) 实现了人工智能系统与各种数据源和工具的无缝交互，保障安全的双向连接。
• 与 Anthropic 的 Claude 等 AI 助手无缝集成，拓展 AI 模型在通话场景的应用。
• 提供丰富的通话相关功能，如构建通话上下文、搜索商家、拨打与安排预约等。

📦 安装指南

先决条件 🔧

在使用 Voyp 之前，您需要：

• Voyp API 密钥
  • 您还需要购买 credits 才能在通话时使用。您也可以在此处购买 credits。
• Claude Desktop，Goose 或其他兼容客户端
• Node.js（v20 或更高版本）
  • 您可以通过运行以下命令验证 Node.js 的安装：

    node --version
    

• npm（Node 包管理器）

安装步骤 🛠️

使用 npm 安装

1. 打开终端并导航到您希望安装 Voyp MCP 服务器的目录。
2. 运行以下命令：

   npm install -g voyp-mcp
   

3. 安装完成后，您可以运行：

   voyp-mcp start
   

   来启动服务器。

手动安装

1. 下载 Voyp MCP 服务器的源代码。
2. 解压文件并进入目录：

   cd voyp-mcp
   

3. 安装依赖项：

   npm install
   

4. 构建项目：

   npm run build
   

💻 使用示例

基础用法

安装完成后，按照以下步骤在 Claude Desktop 应用中配置 Voyp MCP 服务器：

1. 打开 Claude Desktop 应用。
2. 点击底部左侧的锤子图标（.hammer），以查看可用的 MCP 工具。
3. 您应该会看到 start_call 和 hangup_call 工具。

现在，Claude 将拥有对 Voyp MCP 服务器的完全访问权限，包括 start_call 和 hangup_call 工具。

🔧 技术细节

故障排除 🛠️

常见问题

1. 服务器未找到
   • 验证 npm 安装是否正确：运行 npm --version
   • 检查 Claude Desktop 的配置文件语法：运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 确保 Node.js 正确安装：运行 node --version
2. NPX 相关问题
   • 如果遇到与 npx 相关的错误，可能需要使用 npx 的完整路径。
   • 找到路径后，运行 which npx，然后在配置文件中替换 "command": "npx" 为 "/full/path/to/npx"
3. API Key 相关问题
   • 确认您的 VOYP API 密钥有效
   • 检查 API 密钥是否正确设置在配置中
   • 确保密钥没有空格或引号

✨ 致谢

• 模型上下文协议 提供 MCP 规范
• Anthropic 提供 Claude Desktop