Ictpbx Mcp

io.github.ictinnovations由 GitHub 帳號 ictinnovations 發布v0.1.1更新於 Oct 26, 2026

Read ICTPBX state: extensions, DID numbers, SIP trunks, tenants and live PBX statistics.

概覽

AI 產生的概覽

唯讀 MCP 伺服器,讓助理檢視 ICTPBX(ICTCore)電話系統:分機、DID 號碼、SIP 中繼、租戶與 PBX 統計。

可以做什麼
  • 以分機、裝置、響鈴群組、佇列、IVR、語音信箱、會議與閘道的數量掌握 PBX 整體狀況
  • 列出 SIP 分機及其使用者名稱、名稱、租戶與帳號 ID
  • 列出 DID 來電號碼及其啟用狀態、所屬租戶與綁定聯絡人
  • 列出 SIP 中繼供應商及其名稱、主機與租戶
  • 列出多租戶 PBX 上的租戶(客戶組織)及其公司、聯絡人與限制
適用情境
適合管理或支援多租戶 ICTPBX 部署的情境:希望助理回答有哪些分機、來電號碼、中繼與租戶,或在不開啟管理介面的情況下快速掌握伺服器狀態。
執行需求
透過 npx 或全域 npm 安裝後在本機執行,需要 Node.js 18 或更新版本。需要 ICTCore REST 基礎位址(通常以 /api 結尾,變數 ICTPBX_BASE_URL)、API 帳號電子郵件(ICTPBX_USERNAME)及其密碼(ICTPBX_PASSWORD);選用請求逾時(ICTPBX_TIMEOUT_MS)與略過 TLS 驗證(ICTPBX_TLS_INSECURE)。需要能連線至 PBX 伺服器的網路。
安裝前請注意
帳號密碼透過 ICTPBX_PASSWORD 環境變數傳入,請勿寫入共用設定或程式碼儲存庫。伺服器會以該帳號憑證登入,並在工作階段中保存 JWT 權杖。ICTPBX_TLS_INSECURE 會關閉憑證驗證,僅應用於自簽章的測試伺服器。工具雖標示為唯讀,實際可存取的範圍仍受該帳號本身權限限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ictpbx Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ictpbx-mcp

A Model Context Protocol server for ICTPBX, the multi-tenant, white-label IP-PBX built on the ICTCore framework by ICT Innovations.

It lets an AI assistant read your PBX state — extensions, DID numbers, SIP trunk providers, tenants and live statistics — over the ICTCore REST API. It is read-only: it never places a call or changes configuration.

Install

bash
npx -y ictpbx-mcp      # no installnpm install -g ictpbx-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTPBX_BASE_URLyesICTCore REST base, normally ending in /api, e.g. https://your-ictpbx/api
ICTPBX_USERNAMEyesAPI account email (ICTCore logs in by email)
ICTPBX_PASSWORDyesPassword for that account
ICTPBX_TIMEOUT_MSno30000Per-request timeout
ICTPBX_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictpbx": {      "command": "npx",      "args": ["-y", "ictpbx-mcp"],      "env": {        "ICTPBX_BASE_URL": "https://your-ictpbx/api",        "ICTPBX_USERNAME": "[email protected]",        "ICTPBX_PASSWORD": "your-password"      }    }  }}

Tools

ToolWhat it does
ictpbx_pbx_statisticsCounts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences, gateways
ictpbx_list_extensionsSIP extensions with username, name, tenant
ictpbx_list_didsDID (inbound) numbers, active state and tenant
ictpbx_list_providersSIP trunk providers (upstream carriers)
ictpbx_list_tenantsTenants (customer organizations) on the PBX

How it connects

ICTPBX runs on ICTCore, which authenticates with a JWT from POST /authenticate (login by email) and reads it back from the Authorization: Bearer header. The server fetches the token on first use and refreshes it automatically.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTPBX, ICTContact, ICTDialer, ICTFax and the ICTCore framework these products share. Learn more at ictpbx.com.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictpbx-mcp.

來源:README.md,提交 e5ee340

工具

5

ictpbx_pbx_statistics

PBX statistics

Counts across the PBX: extensions, devices, ring groups, call queues, IVR menus, voicemails, conferences and gateways. Use this first for a quick health picture of the server.

無需輸入參數。

ictpbx_list_extensions

List extensions

List SIP extensions on the PBX with their username, name, tenant and account id. Use this to answer 'what extensions exist' or to find an extension's tenant.

無需輸入參數。

ictpbx_list_dids

List DID numbers

List DID (inbound phone) numbers on the PBX: the number, whether it is active, its tenant and the contact it is tied to.

無需輸入參數。

ictpbx_list_providers

List SIP trunk providers

List the SIP trunk providers (upstream carriers) configured on the PBX: name, host and tenant.

無需輸入參數。

ictpbx_list_tenants

List tenants

List the tenants (customer organizations) on this multi-tenant PBX: company, contact and limits. Use this to see who the white-label PBX is serving.

無需輸入參數。

版本歷史

2
  1. v0.1.1最新Oct 26, 2026
  2. v0.1.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分