Boilerplate MCP Server
Шаблон для создания MCP-серверов на TypeScript с инструментами для геолокации IP-адресов.
Описание
Это готовый шаблон для разработки MCP-серверов в TypeScript, обеспечивающий подключение ИИ-систем к внешним API и данным. Ключевые особенности: поддержка STDIO и HTTP-транспортов с fallback, 5-слойная архитектура (CLI, tools, controllers, services, utils), валидация Zod, встроенный пример с geolocation IP через ip-api.com. Технологии: Node.js, TypeScript, Jest для тестов. Применения: интеграция AI-ассистентов (Claude, Cursor) с внешними сервисами, создание кастомных инструментов для IP-локации, отчетов и мониторинга.
Возможности
Двойная поддержка транспортов
STDIO для локальных AI-ассистентов и Streamable HTTP с SSE для веб-интеграций, с автоматическим fallback.
5-слойная архитектура
Разделение на CLI, tools, resources, controllers, services и utils для удобного расширения и поддержки.
Типобезопасность
Полная реализация на TypeScript с валидацией схем Zod для аргументов и ответов.
Пример IP-геолокации
Инструменты и CLI-команды для получения деталей IP (geolocation, ASN) через ip-api.com с fallback на HTTP.
Комплексное тестирование
Unit- и integration-тесты с Jest, покрытием >80%, включая CLI и сервисы.
Обработка ошибок и логирование
Структурированные ошибки MCP, контекстное логирование и инструменты отладки (MCP Inspector).