MCP 服务器

VoIPBin MCP Server

一个模型上下文协议服务器，使人工智能模型能够与 VoIPBin 的 VoIP 服务进行交互，支持呼叫管理、座席管理、营销活动、电话会议和聊天功能等特性。

README

VoIPBin MCP 服务器

一个用于 VoIPBin API 的模型上下文协议 (MCP) 服务器实现，使 AI 模型能够与 VoIP 服务交互。

免责声明

本软件按“原样”提供，不提供任何明示或暗示的保证。作者不对本软件的完整性、可靠性或准确性做出任何保证。使用本软件的风险由您自行承担。作者不对因使用本软件而造成的任何损失负责。

概述

此 MCP 服务器为 AI 模型与 VoIPBin 的 API 服务交互提供了一个标准化的接口。它实现了模型上下文协议规范，并支持 SSE 和 stdio 传输类型。

特性

通过 MCP 协议完全集成 VoIPBin API
支持 stdio 和 SSE 传输模式
具有适当注释的全面工具定义
类型安全的请求/响应处理
异步 HTTP 请求
适当的错误处理和验证
Docker 支持，便于部署

可用工具

呼叫管理

get_calls: 检索呼叫列表，可选择过滤
get_call: 获取特定呼叫的详细信息
create_call: 创建新呼叫
end_call: 结束活动呼叫

代理管理

get_agents: 检索代理列表
get_agent: 获取特定代理的详细信息
update_agent_status: 更新代理的状态

活动管理

get_campaigns: 检索活动列表
get_campaign: 获取特定活动的详细信息
create_campaign: 创建新活动

录音管理

get_recordings: 检索呼叫录音列表
get_recording: 获取特定录音的详细信息

队列管理

get_queues: 检索呼叫队列列表
get_queue: 获取特定队列的详细信息

会议管理

get_conferences: 检索活动会议列表
create_conference: 创建新会议

聊天管理

get_chats: 检索聊天对话列表
send_chat_message: 在聊天对话中发送消息

账单管理

get_billing_info: 检索当前账单信息
get_billing_history: 检索账单历史记录，可选择日期过滤

设置

本地开发设置

创建一个虚拟环境：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

安装依赖项：

pip install -r requirements.txt

创建一个 .env 文件：

cp .env.example .env

使用您的 VoIPBin API 凭据更新 .env 文件：

VOIPBIN_API_URL=https://api.voipbin.net/v1.0
VOIPBIN_API_KEY=your-api-key-here
PORT=8000

Docker 设置

使用 Docker Compose 构建和运行：

# 构建并启动容器
docker-compose up --build

# 在分离模式下运行
docker-compose up -d

# 停止容器
docker-compose down

或者直接使用 Docker 构建和运行：

# 构建镜像
docker build -t voipbin-mcp-server .

# 运行容器
docker run -d \
  -p 8000:8000 \
  -e VOIPBIN_API_KEY=your-api-key-here \
  -e VOIPBIN_API_URL=https://api.voipbin.net/v1.0 \
  voipbin-mcp-server

运行服务器

本地开发

标准 I/O 模式

python src/main.py --transport stdio

SSE 模式

python src/main.py --transport sse --port 8000

Docker

使用 Docker 时，服务器默认以 SSE 模式运行。容器公开端口 8000 用于 SSE 连接。

工具使用示例

创建呼叫

{
  "name": "create_call",
  "arguments": {
    "body": {
      "phone_number": "+1234567890",
      "agent_id": "agent_123",
      "campaign_id": "campaign_456"
    }
  }
}

获取呼叫详细信息

{
  "name": "get_call",
  "arguments": {
    "call_id": "call_789"
  }
}

创建会议

{
  "name": "create_conference",
  "arguments": {
    "body": {
      "name": "Team Meeting",
      "participants": ["+1234567890", "+0987654321"]
    }
  }
}

发送聊天消息

{
  "name": "send_chat_message",
  "arguments": {
    "chat_id": "chat_123",
    "body": {
      "message": "Hello, how can I help you today?"
    }
  }
}