Сервер MCP, который позволяет помощнику ИИ проверять и контролировать Asterisk и FreeSWITCH.

Спросите «какие расширения сейчас отключены?» или «почему мой SIP багажник не регистрируется?» и получите реальный ответ от живого коммутатора, а не догадку.

Разработана Тахиром Альмасом в ICT Innovations, командой ICTCore, ICTContact, ICTDialer, ICTFax и ICTPBX. Клиенты AMI и ESL в этом РЕПО являются той же основой протокола, на которой работают эти продукты.

Почему

Отладка АТС означает запоминание двух очень разных наборов команд. Asterisk говорит на AMI и CLI с сотнями глаголов. FreeSWITCH говорит на ESL со своим собственным словарем. Если вы запустите оба, вы весь день меняете контекст.

pbx-mcp помещает одну хорошо описанную поверхность инструмента перед обеими, поэтому ваш помощник может перейти от «звонков не удается» к sofia status gateway, не указав каждый шаг.

Здесь новый? Руководство пользователя проходит через настройку PBX, конфигурацию клиента, рабочие примеры и устранение неполадок. Это чтение является быстрой ссылкой.

Что видит ваш помощник

Двенадцать инструментов, предназначенных только для чтения, по шесть на двигатель, каждый из которых достаточно хорошо описан, чтобы модель выбрала правильный.

pbx-mcp

An MCP server that lets an AI assistant inspect and control Asterisk and FreeSWITCH.

Ask “which extensions are offline right now?” or “why is my SIP trunk not registering?” and get a real answer from the live switch, not a guess.

Developed by Tahir Almas at ICT Innovations, the team behind ICTCore, ICTContact, ICTDialer, ICTFax and ICTPBX. The AMI and ESL clients in this repo are the same protocol groundwork those products run on.

Why

Debugging a PBX means memorising two very different command sets. Asterisk speaks AMI and a CLI with hundreds of verbs. FreeSWITCH speaks ESL with its own vocabulary. If you run both, you’re context switching all day.

pbx-mcp puts a single, well described tool surface in front of both, so your assistant can go from “calls are failing” to sofia status gateway without you spelling out each step.

New here? The user guide walks through PBX setup, client config, worked examples and troubleshooting. This README is the quick reference.

What your assistant sees

Twelve read-only tools, six per engine, each one described well enough that the model picks the right one without being told. This is the server running under the MCP Inspector:

The four write tools, asterisk_originate, asterisk_hangup, freeswitch_originate and freeswitch_hangup, stay hidden until you set PBX_MCP_ALLOW_WRITE=true.

Install

npm install -g pbx-mcp

Or run it straight from npx, which is what most MCP client configs do:

npx -y pbx-mcp

You need Node 18 or newer.

Docker

There’s a prebuilt image if you’d rather not put Node on the machine that talks to your PBX.

docker run -i --rm \
  -e ASTERISK_AMI_HOST=10.0.0.10 \
  -e ASTERISK_AMI_USERNAME=mcp \
  -e ASTERISK_AMI_PASSWORD=change-me \
  ghcr.io/ictinnovations/pbx-mcp

The same image is on Docker Hub as ictinnovations/pbx-mcp if that registry is an easier pull for you.

Three things to know:

• -i is not optional. The server speaks MCP over stdio, so without stdin attached the container starts and then sits there saying nothing, which looks exactly like a broken server.
• There is no port to publish. Nothing listens.