TcpSocketMCP сервер

MCP сервер, который предоставляет прямой доступ к TCP сокетам, позволяя AI моделям напрямую взаимодействовать с сетевыми сервисами через сырые TCP соединения. Поддерживает множественные одновременные подключения, буферизацию данных ответов и автоматические триггеры.

Установка

PyPI

pip install TcpSocketMCP

UV

uv add TcpSocketMCP

Из исходников

git clone https://github.com/kaseyk/tcp-socket-mcp.git
cd tcp-socket-mcp
uv pip install -e .

Прямой запуск

python run.py

Конфигурация

Claude Desktop (установленный пакет)

{
  "mcpServers": {
    "tcp-socket": {
      "command": "TcpSocketMCP",
      "env": {}
    }
  }
}

Claude Desktop (из исходников)

{
  "mcpServers": {
    "tcp-socket": {
      "command": "python",
      "args": ["/path/to/tcp-socket-mcp/run.py"],
      "env": {}
    }
  }
}

Доступные инструменты

Инструмент	Описание
`tcp_connect`	Открывает TCP соединение с любым хостом:портом, возвращает connection_id для последующих операций
`tcp_send`	Отправляет данные через установленное соединение с опциями кодирования (utf-8, hex, base64)
`tcp_read_buffer`	Читает полученные данные из буфера соединения с поддержкой частичного чтения и опций форматирования
`tcp_disconnect`	Закрывает соединение и освобождает ресурсы, автоматически удаляет все триггеры
`tcp_set_trigger`	Устанавливает автоматические ответы для совпадений по шаблону, поддерживает regex паттерны с группами захвата
`tcp_connect_and_send`	Объединяет connect + send в одну атомарную операцию для чувствительных ко времени протоколов
`tcp_list_connections`	Просмотр всех активных соединений со статистикой
`tcp_connection_info`	Получение детальной информации о конкретном соединении
`tcp_buffer_info`	Проверка статистики буфера без чтения данных
`tcp_clear_buffer`	Очистка полученных данных из буфера
`tcp_remove_trigger`	Удаление конкретного триггера автоответа

Возможности

Прямое взаимодействие с встраиваемыми устройствами и IoT системами
Отладка и тестирование сетевых протоколов
Интеграция с legacy системами без HTTP оберток
Анализ и обратная инженерия протоколов
Автоматические ответы через триггерные паттерны (полезно для IRC, telnet, кастомных протоколов)
Поддержка множественных одновременных подключений
Буферизация данных ответов
Поддержка бинарных протоколов с hex кодированием
Regex сопоставление паттернов для автоматических ответов
Кроссплатформенная совместимость (Ubuntu, Windows, macOS)

Примеры использования

Подключение к веб-серверу и отправка HTTP запросов

Настройка автоматических IRC PING/PONG ответов

Опрос неизвестных устройств для их идентификации

Отправка данных бинарного протокола с использованием hex кодирования

Отладка сетевых протоколов через анализ сырого TCP трафика

Ресурсы

GitHub Repository

Примечания

Hex кодирование рекомендуется для бинарных протоколов и точного контроля окончаний строк. Распространенные hex последовательности включают 0D0A для CRLF, 0A для LF, и 00 для нулевых байтов. Сетевые ответы приходят не мгновенно - используйте tcp_buffer_info для проверки доступности данных. Сервер поддерживает 85% покрытие тестами с комплексным CI/CD и контролем качества.