mcpField
I
ictcontact-mcp

ictcontact-mcp

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

关于 ictcontact-mcp

ictcontact-mcp 是用于监控 ICTContact 和 ICTDialer.com 外呼活动的 MCP 服务。它提供活动及单次呼叫详情，只有显式启用写入后才能启动或停止活动。

主要功能

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

适用场景

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

MCP 相关

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

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "ictinnovations-ictcontact": {
      "command": "npx",
      "args": [
        "-y",
        "ictcontact-mcp"
      ],
      "env": {
        "ICTCONTACT_BASE_URL": "<ICTCONTACT_BASE_URL>",
        "ICTCONTACT_USERNAME": "<ICTCONTACT_USERNAME>",
        "ICTCONTACT_PASSWORD": "<ICTCONTACT_PASSWORD>",
        "ICTCONTACT_MCP_ALLOW_WRITE": "<ICTCONTACT_MCP_ALLOW_WRITE>",
        "ICTCONTACT_TIMEOUT_MS": "<ICTCONTACT_TIMEOUT_MS>",
        "ICTCONTACT_TLS_INSECURE": "<ICTCONTACT_TLS_INSECURE>"
      }
    }
  }
}
启动命令npx -y ictcontact-mcp
需要配置的环境变量
ICTCONTACT_BASE_URLBase URL of your ICTContact / ICTDialer server, without the /rest suffix, e.g. https://your-ictcontact.
ICTCONTACT_USERNAMEAPI account username.
ICTCONTACT_PASSWORD密钥Password for the account.
ICTCONTACT_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.
ICTCONTACT_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 30000.
ICTCONTACT_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.

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

安装包
npmictcontact-mcp0.1.1

工具

4

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

此工具无需参数。

详细介绍

ictcontact-mcp

适用于 ICTContact 及其托管版本 ICTDialer.com 的 模型上下文协议 服务——它们使用 ICT Innovations 提供的同一套呼叫中心引擎。

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

安装

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

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

配置

变量必填默认值
ICTCONTACT_BASE_URL是服务基础 URL，不带 /rest 后缀，例如 https://your-ictcontact
ICTCONTACT_USERNAME是API 账户用户名
ICTCONTACT_PASSWORD是该账户的密码
ICTCONTACT_MCP_ALLOW_WRITE否false解锁启动／停止活动功能（参见安全性）
ICTCONTACT_TIMEOUT_MS否30000单次请求超时时间
ICTCONTACT_TLS_INSECURE否false跳过 TLS 验证——仅用于自签名测试服务
Claude Desktop 示例
{
  "mcpServers": {
    "ictcontact": {
      "command": "npx",
      "args": ["-y", "ictcontact-mcp"],
      "env": {
        "ICTCONTACT_BASE_URL": "https://your-ictcontact",
        "ICTCONTACT_USERNAME": "admin",
        "ICTCONTACT_PASSWORD": "your-password"
      }
    }
  }
}

工具

读取工具始终可用：

工具功能
ictcontact_list_campaigns列出活动（ID 和名称）
ictcontact_campaign_status查看活动的实时状态（运行中、已停止）
ictcontact_campaign_summary统计数据：已接听、失败、真人与机器
ictcontact_campaign_result单次通话结果（联系人、响应、AMD、DNC）

仅当 ICTCONTACT_MCP_ALLOW_WRITE=true 时，才会显示写入工具：

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

安全性

该服务默认只读。启动活动会开始实时外呼，可能产生实际费用，因此除非设置 ICTCONTACT_MCP_ALLOW_WRITE=true，否则根本不会注册 ictcontact_start_campaign 和 ictcontact_stop_campaign。

连接方式

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

关于

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

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

评论

支持 Markdown

第一次接触 MCP？

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

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