ictfax-mcp

ictfax-mcp

ICT Innovations が開発した ICTCore フレームワークを基盤とするオープンソースの FAX サーバー、ICTFax 用の Model Context Protocol サーバーです。

AI アシスタントから FAX の送信履歴を一覧表示してステータスを確認できます。また、書き込みを有効にした場合に限り、ドキュメントをアップロードして FAX を送信できます。

インストール

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	FAX の送信元となるアカウント 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	FAX の送信履歴（ID、連絡先、ステータス、方向）を一覧表示します
ictfax_get_fax_status	ID を指定して、1 件の送信履歴のステータスを確認します

書き込みツールは ICTFAX_MCP_ALLOW_WRITE=true の場合にのみ表示されます。

ツール	機能
ictfax_upload_document	ローカルの PDF を FAX ドキュメントとしてアップロードし、document_id を返します
ictfax_send_fax	ローカルのドキュメントを番号宛てに FAX 送信します — 実際の番号に発信します

安全性

このサーバーはデフォルトで読み取り専用です。FAX の送信では実際の番号に発信し、料金が発生する場合があるため、ICTFAX_MCP_ALLOW_WRITE=true を設定しない限り、ictfax_upload_document と ictfax_send_fax は登録されません。

接続方法

ICTFax は ICTCore 上で動作します。ICTCore は POST /authenticate で JWT 認証を行い（メールアドレスでログイン）、Authorization: Bearer ヘッダーから JWT を読み取ります。FAX の送信は、サーバーが処理する次の短い手順で行われます。ドキュメントをアップロードし（メタデータの後に生バイトを送信します。ICTFax が FAX 形式に変換します）、受信者と sendfax プログラムを作成し、送信履歴を作成して送信します。

概要

ICTFax、ICTPBX、ICTContact、ICTDialer、およびこれらが共有する ICTCore フレームワークを開発した ICT Innovations の Tahir Almas が開発しました。ICTFax は無料のオープンソースソフトウェアです。詳細は ictfax.org をご覧ください。

MIT ライセンスです。github.com/ictinnovations/ictfax-mcp で Issue や PR を歓迎します。