Разработчик собрал MCP-сервер на Node.js без SDK за 360 строк
Разработчик подключил сервис коротких ссылок к агентам вроде Claude Code и Cursor через MCP-сервер примерно на 360 строк на чистом Node.js без SDK и зависимостей. MCP (Model Context Protocol) позволяет агенту вызывать внешние инструменты: модель пишет рассылку или release notes, создаёт ссылку с UTM-метками и затем смотрит клики по ней.
Сервер работает как тонкая обёртка над существующим REST API с ключом и не содержит своей логики: он принимает вызов инструмента, обращается к API и возвращает ответ. Валидация, лимиты и проверки безопасности остаются на сервере API, поэтому изменение правил сразу видят все MCP-клиенты без обновления пакета. Локально сервер запускается через npx, ему нужны только ключ и адрес API.
Локальный сервер общается с клиентом через stdin и stdout сообщениями JSON-RPC 2.0 по одной строке JSON. Парсер также понимает формат LSP с заголовком Content-Length, а входящие данные собирает в буфер, так как одно сообщение может разрезаться на части. В stdout запрещено писать что-либо кроме протокола: один случайный console.log ломает клиенту парсинг, поэтому вся отладка идёт в stderr.
Ошибки API сервер возвращает как обычный результат инструмента с флагом isError: true, а не как ошибку протокола. Так текст ошибки попадает модели в контекст как данные, и агент, например, не повторяет запрос при ошибке 401, а говорит пользователю, где взять ключ. Ошибки протокола остались только для неизвестного метода или инструмента и невалидного JSON.
Для опасных инструментов указаны подсказки: удаление и отключение ссылки помечены destructiveHint: true, чтение списка и статистики — readOnlyHint: true. В описании удаления есть фраза «This cannot be undone», после которой модель сама переспрашивает пользователя. Это подсказки, а не защита: реальные ограничения обеспечивают права ключа и проверки на сервере API.
Существующие UTM-параметры в URL не перезаписываются, а якорь #fragment сохраняется, и это правило прописано в описании инструмента. Пакетная операция shorten_urls возвращает объекты created и errors, поэтому при частичном успехе модель видит, какие ссылки создались, а какие нет, и повторяет только нужные. QR-код инструмент get_qr отдаёт картинкой через тип контента image, а не base64-текстом.
Разработчик советует сразу проектировать ответы API под модель, проверять сервер на нескольких клиентах с первого дня и не писать своё без нужды: для проектов с ресурсами, промптами и HTTP-транспортом официальный SDK сэкономит время. Код сервера опубликован в пакете linkbit-mcp на npm.