@textbee/mcp

MCP-сервер для textbee.dev — открытого SMS-шлюза, который превращает Android-телефон в SMS API. Даёт Claude Desktop, Claude Code, Cursor и любому MCP-клиенту возможность отправлять и читать SMS через ваш собственный телефон и ваш номер.

Три инструмента, без разметки для каждого сообщения, работает с самостоятельно размещёнными экземплярами textbee.

Настройка

Вам нужна учётная запись textbee с сопряжённым Android-устройством и API-ключ из панели управления. Ключ имеет полный доступ к учётной записи; обращайтесь с ним как с паролем.

Claude Code

claude mcp add textbee -s user -e TEXTBEE_API_KEY=your-key -- npx -y @textbee/mcp

Claude Desktop

Добавьте в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "textbee": {
      "command": "npx",
      "args": ["-y", "@textbee/mcp"],
      "env": { "TEXTBEE_API_KEY": "your-key" }
    }
  }
}

Cursor

Тот же объект в ~/.cursor/mcp.json.

Медленный первый запуск

npx загружает пакет при первом запуске. Если ваш клиент выходит по тайм-ауту, установите пакет глобально один раз и укажите в конфигурации путь к бинарному файлу:

npm install -g @textbee/mcp

{ "mcpServers": { "textbee": { "command": "textbee-mcp", "env": { "TEXTBEE_API_KEY": "your-key" } } } }

Related MCP server: commune-mcp

Инструменты

send_sms

Отправляет SMS одному или нескольким получателям (формат E.164, например +15550100123). Телефон для отправки выбирается автоматически: ваше устройство по умолчанию, иначе включённое устройство с самым недавним heartbeat. Необязательные параметры: device_id, sim_subscription_id и scheduled_at. Возвращает sms_batch_id для проверки доставки, когда в учётной записи используется очередь SMS.

get_messages

Читает сообщения со всех устройств учётной записи. По умолчанию — полученные сообщения, сначала новые. Фильтры: direction (received, sent, all), произвольный текст search, sms_batch_id (статус доставки по каждому получателю), device_ids и временное окно from/to. Поддерживает курсорную пагинацию для опроса без дубликатов и пропусков.

list_devices

Телефоны в учётной записи: идентификаторы, состояние включения, какой отправляет по умолчанию, последняя проверка и количество сообщений.

Самостоятельно размещённый textbee

Укажите серверу ваш собственный экземпляр:

"env": {
  "TEXTBEE_API_KEY": "your-key",
  "TEXTBEE_BASE_URL": "https://sms.example.com"
}

Суффикс /api/v1 необязателен и добавляется автоматически. Развёртывания с подпутями, например https://example.com/textbee, тоже работают. Неверный URL вызывает ошибку, а не тихий откат, поэтому опечатка никогда не отправит ваш ключ в публичный API.

Переменные окружения

Примечания

• Ваш ключ остаётся на вашей машине: этот сервер общается только с API textbee по указанному выше базовому URL.

• Отправки учитываются в квоте вашего тарифа textbee, а ограничения скорости тарифа применяются на стороне сервера.

• Все диагностические сообщения идут в stderr; stdout зарезервирован для протокола MCP.

Использование в качестве библиотеки

Пакет также экспортирует определения своих инструментов для встраивания в другой MCP-хост (именно так размещённая удалённая конечная точка переиспользует их):

import { createTextbeeMcpServer, staticCredentials, loadConfig } from '@textbee/mcp'

const server = createTextbeeMcpServer({
  credentials: staticCredentials(loadConfig(process.env)),
})

Учётные данные разрешаются при каждом вызове инструмента, поэтому многопользовательский хост может подставлять разный ключ для каждого запроса. См. credentialsFromAuthInfoExtra.

Лицензия

MIT. Часть проекта textbee.