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 分