使用说明

项目简介: Voyp MCP服务器是一个桥梁，连接了支持Model Context Protocol (MCP) 的LLM客户端（如Claude Desktop, Goose）和Voyp电话服务。它允许LLM通过MCP协议调用Voyp的API来发起、挂断电话，并查询地点信息，从而扩展LLM在实际应用场景中的能力，例如通过LLM控制拨打电话预定餐厅、进行咨询等。

主要功能点:

• 电话呼叫: 允许LLM客户端通过 'start_call' 工具发起电话呼叫，并提供呼叫号码、呼叫上下文等参数。
• 挂断电话: 允许LLM客户端通过 'hangup_call' 工具挂断指定ID的电话呼叫。
• 地点搜索: 提供 'search_places', 'search_place', 'search_place_by_number' 等工具，允许LLM客户端查询地点信息。
• 用户信息获取: 提供 'get_user' 工具，允许LLM客户端获取Voyp用户信息。
• 呼叫信息获取: 提供 'get_call' 工具，允许LLM客户端获取指定ID的呼叫详情。

安装步骤:

1. 安装Node.js 和 npm: 确保你的系统安装了Node.js (v20 或更高版本) 和 npm。
2. 获取Voyp API Key: 访问 Voyp官网 注册并获取API Key，同时可能需要购买credits用于电话呼叫。
3. 安装Voyp MCP服务器:
   • 方法一：使用 Smithery (推荐 Claude Desktop 用户):

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

   • 方法二：使用 NPX:

     npx -y [email protected]
     

   • 方法三：Git 安装:

     git clone https://github.com/paulotaylor/voyp-mcp.git
     cd voyp-mcp
     npm install
     npm run build
     

4. 配置MCP客户端: 以Claude Desktop为例，编辑配置文件 'claude_desktop_config.json' (macOS 路径: '"$HOME/Library/Application Support/Claude/claude_desktop_config.json"', Windows 路径: '%APPDATA%\Claude\claude_desktop_config.json')，添加Voyp MCP服务器配置。

服务器配置 (Claude Desktop 客户端配置示例):

{
  "mcpServers": {
    "voyp-mcp": {
      "command": "npx",
      "args": ["-y", "voyp-mcp"],
      "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"  // 将 "your-VOYP-api-key" 替换为你的 Voyp API Key
      }
    }
  }
}

如果使用Git安装，'args' 需指向构建后的 index.js 文件路径:

{
  "mcpServers": {
    "voyp": {
      "command": "npx",
      "args": ["/path/to/voyp-mcp/build/index.js"], // 将 "/path/to/voyp-mcp" 替换为你的仓库克隆路径
      "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"  // 将 "your-VOYP-api-key" 替换为你的 Voyp API Key
      }
    }
  }
}

基本使用方法:

1. 启动Voyp MCP服务器 (如果使用 NPX 或 Git 安装，需要手动启动)。使用 Smithery 安装会自动处理启动。
2. 启动或重启配置好的MCP客户端 (如 Claude Desktop, Goose)。
3. 在MCP客户端中，LLM可以通过识别工具 'start_call', 'hangup_call' 等来调用Voyp的电话功能。例如，在Claude中，你可以指示Claude "call +14155551212 to order pizza"。Claude 应该能识别 'start_call' 工具并调用 Voyp MCP 服务器来发起呼叫。