ictfax-mcp

ictfax-mcp

一个适用于 ICTFax 的 Model Context Protocol 服务。ICTFax 是由 ICT Innovations 基于 ICTCore 框架构建的开源传真服务。

它允许 AI 助手列出传真传输记录并检查状态；只有在启用写入功能后，才能上传文档并发送传真。

安装

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

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

配置

变量	必填	默认值
ICTFAX_BASE_URL	是		ICTCore REST 基础 URL，通常以 /api 结尾，例如 https://your-ictfax/api
ICTFAX_USERNAME	是		API 账户邮箱（ICTCore 使用邮箱登录）
ICTFAX_PASSWORD	是		该账户的密码
ICTFAX_ACCOUNT_ID	否	1	用于发送传真的账户 ID
ICTFAX_MCP_ALLOW_WRITE	否	false	解锁上传和发送功能（参见安全性）
ICTFAX_TIMEOUT_MS	否	30000	每个请求的超时时间
ICTFAX_TLS_INSECURE	否	false	跳过 TLS 验证——仅用于自签名测试服务

Claude Desktop 示例

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

工具

读取工具始终可用：

工具	功能
ictfax_list_faxes	列出传真传输记录（ID、联系人、状态、方向）
ictfax_get_fax_status	按 ID 查询单条传真传输记录的状态

仅当 ICTFAX_MCP_ALLOW_WRITE=true 时，才会提供写入工具：

工具	功能
ictfax_upload_document	将本地 PDF 上传为传真文档；返回一个 document_id
ictfax_send_fax	将本地文档作为传真发送至指定号码——会拨打真实号码

安全性

该服务默认只读。发送传真会拨打真实号码并可能产生费用，因此除非设置 ICTFAX_MCP_ALLOW_WRITE=true，否则根本不会注册 ictfax_upload_document 和 ictfax_send_fax。

连接方式

ICTFax 运行在 ICTCore 上，通过 POST /authenticate 获取 JWT 进行身份验证（使用邮箱登录），并从 Authorization: Bearer 标头读取 JWT。发送传真需要执行一系列操作，服务会代你完成：上传文档（先上传元数据，再上传原始字节；ICTFax 会将其转换为传真格式）、创建收件人和 sendfax 程序、创建传真传输记录并发送。

关于

由 Tahir Almas 在 ICT Innovations 开发——该团队也是 ICTFax、ICTPBX、ICTContact、ICTDialer 以及这些产品共用的 ICTCore 框架的幕后团队。ICTFax 免费且开源；了解详情，请访问 ictfax.org。

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