mcpField
I
ictdialer-mcp

ictdialer-mcp

本地服务
ictdialer.com通信协作162 天前更新
代码仓库访问官网

关于 ictdialer-mcp

ictdialer-mcp 是用于监控 ICTDialer 外呼活动的 MCP 服务，ICTDialer 是云端自动拨号和预测式拨号平台。它提供活动及单次呼叫详情，默认禁用启动和停止操作。

主要功能

  1. 01列出外呼活动
  2. 02查看活动实时状态
  3. 03查看活动汇总和呼叫结果
  4. 04显式启用启动与停止操作

适用场景

  1. 01检查活动进度和结果
  2. 02查看单次呼叫的结果
  3. 03启用写入后启动或停止活动

MCP 相关

向 MCP 客户端提供活动列表、状态、汇总和单次呼叫结果工具。只有设置 ICTDIALER_MCP_ALLOW_WRITE=true 后才会注册启动和停止工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ictinnovations-ictdialer": {
      "command": "npx",
      "args": [
        "-y",
        "ictdialer-mcp"
      ],
      "env": {
        "ICTDIALER_BASE_URL": "<ICTDIALER_BASE_URL>",
        "ICTDIALER_USERNAME": "<ICTDIALER_USERNAME>",
        "ICTDIALER_PASSWORD": "<ICTDIALER_PASSWORD>",
        "ICTDIALER_MCP_ALLOW_WRITE": "<ICTDIALER_MCP_ALLOW_WRITE>",
        "ICTDIALER_TIMEOUT_MS": "<ICTDIALER_TIMEOUT_MS>",
        "ICTDIALER_TLS_INSECURE": "<ICTDIALER_TLS_INSECURE>"
      }
    }
  }
}
启动命令npx -y ictdialer-mcp
需要配置的环境变量
ICTDIALER_BASE_URLBase URL of your ICTDialer server, without the /rest suffix, e.g. https://your-ictdialer.
ICTDIALER_USERNAMEAPI account username.
ICTDIALER_PASSWORD密钥Password for the account.
ICTDIALER_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.
ICTDIALER_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 30000.
ICTDIALER_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmictdialer-mcp0.1.1

工具

4

收录的工具列表 · 更新于 2 天前

此工具无需参数。

详细介绍

ictdialer-mcp

一个用于 ICTDialer 的 Model Context Protocol 服务。ICTDialer 是 ICT Innovations 推出的云端自动拨号和预测式拨号平台。ICTDialer.com 是 ICTContact 的托管版，运行相同的引擎，因此此服务使用该 API。

它让 AI 助手能够监控外呼活动——列出活动、检查状态、读取摘要和单通电话结果；只有启用写入功能后，才能启动和停止活动。

安装

npx -y ictdialer-mcp      # no install
npm install -g ictdialer-mcp

需要 Node.js 18 或更高版本。

配置

变量必填默认值
ICTDIALER_BASE_URL是服务基础 URL，不含 /rest 后缀，例如 https://your-ictdialer
ICTDIALER_USERNAME是API 账户用户名
ICTDIALER_PASSWORD是该账户的密码
ICTDIALER_MCP_ALLOW_WRITE否false解锁活动的启动/停止功能（见安全性）
ICTDIALER_TIMEOUT_MS否30000每个请求的超时时间
ICTDIALER_TLS_INSECURE否false跳过 TLS 验证——仅适用于使用自签名证书的测试服务
Claude Desktop 配置示例
{
  "mcpServers": {
    "ictdialer": {
      "command": "npx",
      "args": ["-y", "ictdialer-mcp"],
      "env": {
        "ICTDIALER_BASE_URL": "https://your-ictdialer",
        "ICTDIALER_USERNAME": "admin",
        "ICTDIALER_PASSWORD": "your-password"
      }
    }
  }
}

工具

始终提供读取工具：

工具功能
ictdialer_list_campaigns列出活动（ID 和名称）
ictdialer_campaign_status活动的实时状态（运行中、已停止）
ictdialer_campaign_summary统计总数：已接听、失败、真人与机器
ictdialer_campaign_result单通电话结果（联系人、响应、AMD、DNC）

仅当 ICTDIALER_MCP_ALLOW_WRITE=true 时才会提供写入工具：

工具功能
ictdialer_start_campaign启动活动——开始实时外呼
ictdialer_stop_campaign停止正在运行的活动

安全性

此服务默认只读。启动活动会开始实时外呼，并可能产生实际费用，因此除非设置 ICTDIALER_MCP_ALLOW_WRITE=true，否则不会注册 ictdialer_start_campaign 和 ictdialer_stop_campaign。

连接方式

ICTDialer 在 {base}/rest/<Method> 提供表单编码的 RPC API。每次调用都需要携带账户用户名和密码；服务会代你发送这些信息。无需另行申请令牌。

关于

由 Tahir Almas 在 ICT Innovations 开发——该团队还打造了 ICTDialer、ICTContact、ICTBroadcast、ICTFax 和 ICTPBX。了解更多信息，请访问 ictdialer.com。

采用 MIT 许可证。欢迎在 github.com/ictinnovations/ictdialer-mcp 提交问题和 PR。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。