关于 ictbroadcast-mcp
ictbroadcast-mcp 是用于监控 ICTBroadcast 外呼活动的 MCP 服务;显式启用写入后,也可启动或停止活动。它提供活动及单次呼叫详情,默认禁用写操作。
主要功能
- 01列出外呼活动
- 02查看活动实时状态
- 03查看活动汇总和呼叫结果
- 04显式启用启动与停止操作
适用场景
- 01检查活动进度和结果
- 02查看单次呼叫的结果
- 03启用写入后启动或停止活动
MCP 相关
向 MCP 客户端提供活动列表、状态、汇总和单次呼叫结果工具。只有设置 ICTBROADCAST_MCP_ALLOW_WRITE=true 后才会注册启动和停止工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y ictbroadcast-mcpICTBROADCAST_BASE_URLBase URL of your ICTBroadcast server, without the /rest suffix, e.g. https://your-ictbroadcast.ICTBROADCAST_USERNAMEAPI account username.ICTBROADCAST_PASSWORD密钥Password for the account.ICTBROADCAST_MCP_ALLOW_WRITEUnlocks starting and stopping campaigns, which begins live outbound calling and can cost money. When false those tools are not registered at all. Leave off unless you mean it.ICTBROADCAST_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 30000.ICTBROADCAST_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
4收录的工具列表 · 更新于 2 天前
此工具无需参数。
详细介绍
ictbroadcast-mcp
一个用于 ICTBroadcast 的 Model Context Protocol 服务。ICTBroadcast 是由 ICT Innovations 推出的语音、短信和传真群发及呼叫中心平台。
它允许 AI 助手监控外呼活动——列出活动、查看状态、读取摘要和逐通电话结果;只有启用写入功能后,才能启动和停止活动。
安装
npx -y ictbroadcast-mcp # no install
npm install -g ictbroadcast-mcp
需要 Node.js 18 或更高版本。
配置
| 变量 | 必需 | 默认值 | |
|---|---|---|---|
ICTBROADCAST_BASE_URL | 是 | 服务基础 URL,不带 /rest 后缀,例如 https://your-ictbroadcast | |
ICTBROADCAST_USERNAME | 是 | API 账户用户名 | |
ICTBROADCAST_PASSWORD | 是 | 该账户的密码 | |
ICTBROADCAST_MCP_ALLOW_WRITE | 否 | false | 解锁活动的启动和停止功能(参见安全性) |
ICTBROADCAST_TIMEOUT_MS | 否 | 30000 | 每个请求的超时时间 |
ICTBROADCAST_TLS_INSECURE | 否 | false | 跳过 TLS 验证——仅用于自签名测试服务 |
Claude Desktop 示例
{
"mcpServers": {
"ictbroadcast": {
"command": "npx",
"args": ["-y", "ictbroadcast-mcp"],
"env": {
"ICTBROADCAST_BASE_URL": "https://your-ictbroadcast",
"ICTBROADCAST_USERNAME": "admin",
"ICTBROADCAST_PASSWORD": "your-password"
}
}
}
}
工具
读取工具始终可用:
| 工具 | 功能 |
|---|---|
ictbroadcast_list_campaigns | 列出活动(ID 和名称) |
ictbroadcast_campaign_status | 查看活动实时状态(运行中、已停止) |
ictbroadcast_campaign_summary | 统计数据:已接听、失败、人类与机器 |
ictbroadcast_campaign_result | 逐通电话结果(联系人、响应、AMD、DNC) |
仅当 ICTBROADCAST_MCP_ALLOW_WRITE=true 时,才会显示写入工具:
| 工具 | 功能 |
|---|---|
ictbroadcast_start_campaign | 启动活动——开始实时外呼 |
ictbroadcast_stop_campaign | 停止正在运行的活动 |
安全性
该服务默认只读。启动活动会开始实时外呼,可能产生实际费用,因此除非设置 ICTBROADCAST_MCP_ALLOW_WRITE=true,否则不会注册 ictbroadcast_start_campaign 和 ictbroadcast_stop_campaign。
连接方式
ICTBroadcast 在 {base}/rest/<Method> 提供表单编码的 RPC API。每次调用都需要携带账户用户名和密码;服务会代为发送。无需单独申请令牌。(ICTBroadcast REST API 随 Service Provider 版本提供。)
关于
由 Tahir Almas 在 ICT Innovations 开发——该团队还开发了 ICTBroadcast、ICTContact、ICTDialer、ICTFax 和 ICTPBX。了解详情,请访问 ictbroadcast.com。
采用 MIT 许可协议。欢迎通过 github.com/ictinnovations/ictbroadcast-mcp 提交问题和 PR。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。