VoIPBin MCP Server

基本能力

产品定位

VoIPBin MCP Server 是一个为 AI 模型提供与 VoIP 服务交互的标准化接口的服务。

核心功能

• 完整的 VoIPBin API 集成，通过 MCP 协议实现
• 支持 stdio 和 SSE 两种传输模式
• 类型安全的请求/响应处理
• 异步 HTTP 请求
• 完善的错误处理和验证
• Docker 支持，便于部署

适用场景

• AI 模型与 VoIP 服务的交互
• 自动化呼叫中心管理
• 会议和聊天管理
• 计费和录音管理

工具列表

Call Management

• get_calls: 获取通话列表，支持过滤
• get_call: 获取特定通话的详细信息
• create_call: 创建新通话
• end_call: 结束当前通话

Agent Management

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

Campaign Management

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

Recording Management

• get_recordings: 获取录音列表
• get_recording: 获取特定录音的详细信息

Queue Management

• get_queues: 获取队列列表
• get_queue: 获取特定队列的详细信息

Conference Management

• get_conferences: 获取会议列表
• create_conference: 创建新会议

Chat Management

• get_chats: 获取聊天列表
• send_chat_message: 发送聊天消息

Billing Management

• get_billing_info: 获取当前计费信息
• get_billing_history: 获取计费历史，支持日期过滤

常见问题解答

• 错误处理包括无效的 API 凭证、网络连接问题、无效的请求参数、速率限制和服务器错误。

使用教程

使用依赖

1. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 安装依赖：

pip install -r requirements.txt

1. 创建 .env 文件：

cp .env.example .env

1. 更新 .env 文件：

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

安装教程

Docker 安装

1. 使用 Docker Compose 构建和运行：

docker-compose up --build

1. 或直接使用 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

调试方式

本地开发

1. 标准 I/O 模式：

python src/main.py --transport stdio

1. SSE 模式：

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

Docker

默认在 SSE 模式下运行，端口 8000 用于 SSE 连接。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。