mcpField
I
ictpbx-mcp

ictpbx-mcp

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

关于 ictpbx-mcp

ictpbx-mcp 是面向 ICTPBX 的只读 MCP 服务，供需要查看 PBX 配置与实时统计的助手使用。它通过 ICTCore REST API 获取数据，不会拨打电话或更改设置。

主要功能

  1. 01查看 PBX 统计数据
  2. 02列出 SIP 分机
  3. 03列出入站 DID 号码
  4. 04列出 SIP 中继提供商
  5. 05列出 PBX 租户

适用场景

  1. 01查看分机和设备数量
  2. 02按租户检查入站号码
  3. 03检查 SIP 中继提供商
  4. 04查看 PBX 上的客户组织

MCP 相关

通过五个只读工具向 MCP 客户端提供 ICTPBX 状态。它通过 ICTCore REST API 认证，并自动刷新 JWT。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "ictinnovations-ictpbx": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>",
        "ICTPBX_TIMEOUT_MS": "<ICTPBX_TIMEOUT_MS>",
        "ICTPBX_TLS_INSECURE": "<ICTPBX_TLS_INSECURE>"
      }
    }
  }
}
启动命令npx -y ictpbx-mcp
需要配置的环境变量
ICTPBX_BASE_URLICTCore REST base URL of your ICTPBX server, normally ending in /api, e.g. https://your-ictpbx/api.
ICTPBX_USERNAMEAPI account email (ICTCore logs in by email).
ICTPBX_PASSWORD密钥Password for the account.
ICTPBX_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 30000.
ICTPBX_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.

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

安装包
npmictpbx-mcp0.1.1

工具

5

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

此工具无需参数。

详细介绍

ictpbx-mcp

一个面向 ICTPBX 的 Model Context Protocol 服务。ICTPBX 是由 ICT Innovations 基于 ICTCore 框架构建的多租户白标 IP-PBX。

它可通过 ICTCore REST API，让 AI 助手读取 PBX 状态，包括分机、DID 号码、SIP 中继提供商、租户和实时统计数据。它是只读的：不会拨打电话，也不会更改配置。

安装

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

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

配置

变量必填默认值
ICTPBX_BASE_URL是ICTCore REST 基础 URL，通常以 /api 结尾，例如 https://your-ictpbx/api
ICTPBX_USERNAME是API 账户邮箱（ICTCore 通过邮箱登录）
ICTPBX_PASSWORD是该账户的密码
ICTPBX_TIMEOUT_MS否30000每次请求的超时时间
ICTPBX_TLS_INSECURE否false跳过 TLS 验证——仅用于自签名测试服务
Claude Desktop 示例
{
  "mcpServers": {
    "ictpbx": {
      "command": "npx",
      "args": ["-y", "ictpbx-mcp"],
      "env": {
        "ICTPBX_BASE_URL": "https://your-ictpbx/api",
        "ICTPBX_USERNAME": "[email protected]",
        "ICTPBX_PASSWORD": "your-password"
      }
    }
  }
}

工具

工具功能
ictpbx_pbx_statistics统计分机、设备、振铃组、队列、IVR、语音信箱、会议和网关数量
ictpbx_list_extensionsSIP 分机及其用户名、名称和租户
ictpbx_list_didsDID（入站）号码、启用状态和租户
ictpbx_list_providersSIP 中继提供商（上游运营商）
ictpbx_list_tenantsPBX 上的租户（客户组织）

连接方式

ICTPBX 运行在 ICTCore 上，通过 POST /authenticate（使用邮箱登录）获取 JWT 进行身份验证，并从 Authorization: Bearer 标头中读取该令牌。服务会在首次使用时获取令牌，并自动刷新。

关于

由 Tahir Almas 在 ICT Innovations 开发——该团队还开发了 ICTPBX、ICTContact、ICTDialer、ICTFax 及这些产品共用的 ICTCore 框架。了解更多信息，请访问 ictpbx.com。

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

评论

支持 Markdown

第一次接触 MCP？

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

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