Ictfax Mcp

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

List and track faxes on ICTFax, and send faxes when writes are enabled, over ICTCore REST.

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

透過 ICTCore REST 將助理連接到 ICTFax 伺服器，用來列出與追蹤傳真傳輸，並可選擇上傳與發送傳真。

可以做什麼
  • 列出傳真傳輸，包含編號、聯絡人、狀態與方向
  • 依編號查詢單筆傳輸的狀態、聯絡人與頁數
  • 啟用寫入後：上傳本機 PDF 作為傳真文件並發送到指定號碼
適用情境
當你自行架設 ICTFax 伺服器，希望助理查看收發傳真狀態，或在明確開啟寫入後從本機 PDF 準備並發送傳真時適用。
執行需求
以本機程序執行（npx 或全域 npm 安裝），需要 Node.js 18 或更新版本。需設定 ICTFAX_BASE_URL（ICTCore REST 基礎位址，通常以 /api 結尾）、ICTFAX_USERNAME（帳號電子郵件）與 ICTFAX_PASSWORD。選用：ICTFAX_ACCOUNT_ID、ICTFAX_MCP_ALLOW_WRITE、ICTFAX_TIMEOUT_MS、ICTFAX_TLS_INSECURE。需要能連線到傳真伺服器的網路。
安裝前請注意
ICTFAX_PASSWORD 是必須提供的密鑰，存放於環境變數中。設定 ICTFAX_MCP_ALLOW_WRITE=true 會註冊上傳與發送工具，會撥打真實號碼並可能產生費用，非必要請勿開啟。ICTFAX_TLS_INSECURE 會略過憑證驗證，僅適用於自簽測試伺服器。傳真內容與帳號憑證會傳送到所設定的 ICTFax 伺服器。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

ictfax-mcp

A Model Context Protocol server for ICTFax, the open-source fax server built on the ICTCore framework by ICT Innovations.

It lets an AI assistant list fax transmissions and check their status, and — only when you turn writes on — upload a document and send a fax.

Install

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

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTFAX_BASE_URLyesICTCore REST base, normally ending in /api, e.g. https://your-ictfax/api
ICTFAX_USERNAMEyesAPI account email (ICTCore logs in by email)
ICTFAX_PASSWORDyesPassword for that account
ICTFAX_ACCOUNT_IDno1Account id to send faxes from
ICTFAX_MCP_ALLOW_WRITEnofalseUnlock upload/send (see Safety)
ICTFAX_TIMEOUT_MSno30000Per-request timeout
ICTFAX_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictfax": {      "command": "npx",      "args": ["-y", "ictfax-mcp"],      "env": {        "ICTFAX_BASE_URL": "https://your-ictfax/api",        "ICTFAX_USERNAME": "[email protected]",        "ICTFAX_PASSWORD": "your-password"      }    }  }}

Tools

Read tools are always available:

ToolWhat it does
ictfax_list_faxesList fax transmissions (id, contact, status, direction)
ictfax_get_fax_statusStatus of one transmission by id

Write tools appear only when ICTFAX_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictfax_upload_documentUpload a local PDF as a fax document; returns a document_id
ictfax_send_faxSend a local document as a fax to a number — dials a real number

Safety

The server is read-only by default. Sending a fax dials a real number and can cost money, so ictfax_upload_document and ictfax_send_fax are not registered at all unless you set ICTFAX_MCP_ALLOW_WRITE=true.

How it connects

ICTFax runs on ICTCore, which authenticates with a JWT from POST /authenticate (login by email) and reads it back from the Authorization: Bearer header. Sending a fax is a short chain the server handles for you: upload the document (metadata then raw bytes, which ICTFax converts to fax format), create the recipient and a sendfax program, create the transmission and send it.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTFax, ICTPBX, ICTContact, ICTDialer and the ICTCore framework these share. ICTFax is free and open source; learn more at ictfax.org.

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

來源：README.md，提交 e0ab40e

工具

2

ictfax_list_faxes

List fax transmissions

List fax transmissions on the server (inbound and outbound) with their id, contact, status and direction. Start here to find a transmission id.

無需輸入參數。

ictfax_get_fax_status

Get fax status

Get one fax transmission by id: its status (processing, completed, failed), contact and pages. Poll this after sending a fax.

輸入參數transmission_id必填

版本歷史

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

評分

已滿足適用檢查項的 90%

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

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

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

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