mcp-server
mcp-server — официальный MCP-сервер от spanlens. Запросы к наблюдаемости LLM в Spanlens из Cursor, Claude Desktop или Continue. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- spanlens
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Только публичные ключи sl_live_pub_ (чтение); с ключом полного доступа сервер не стартует.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"spanlens\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@spanlens/mcp-server\"],\n \"env\": { \"SPANLENS_API_KEY\": \"sl_live_pub_...\" }\n }\n }\n}",
"file": "~/.cursor/mcp.json",
"lang": "json",
"verified": "docs"
}
Что умеет
@spanlens/mcp-server позволяет запрашивать данные наблюдаемости LLM из Spanlens прямо в Cursor, Continue или Claude Desktop. Агенту в IDE можно задать вопросы вроде «сколько мы потратили на OpenAI за неделю?», «есть ли аномалии по стоимости?» или «покажи самую дорогую трассировку за сегодня» — ответы придут из вашего рабочего пространства Spanlens.
Семь инструментов:
get_stats— суммарная стоимость, число запросов, токены, задержка и доля ошибок. ПараметрgroupByдаёт разбивку по моделям (model) или провайдерам (provider).query_requests— отдельные запросы к LLM со стоимостью, задержкой, моделью и текстом ошибки. Фильтры: модель, провайдер, статус, пользователь, период, лимит.list_traces— сводки трассировок агентов: имя, статус, длительность, число спанов, токены и стоимость.get_trace— полное дерево спанов трассировки: каждый вызов LLM, инструмента или поиска со временем, токенами и стоимостью.get_anomalies— найденные платформой аномалии стоимости, задержки и доли ошибок; можно задать окно наблюдения и чувствительность (sigma).get_savings— рекомендации по замене моделей с прогнозом месячной экономии.get_user_analytics— расход по конечным пользователям: стоимость, число запросов, модели, недавние вызовы.
Кому подойдёт
Командам, которые уже собирают телеметрию LLM-приложений в Spanlens и хотят разбирать расходы, ошибки и трассировки агентов, не выходя из редактора. Поддерживается и самостоятельно размещённый Spanlens. Похожие серверы — в категории данные и аналитика.
Установка
Нужен Node.js и публичный ключ Spanlens (sl_live_pub_…). Он создаётся на spanlens.io/projects: карточка Public Keys → + New public key. Публичные ключи только читают данные и не могут тратить деньги через LLM-прокси. Сервер не запустится с ключом полного доступа (sl_live_*), потому что ключ хранится открытым текстом в конфигурации IDE.
Переменные: SPANLENS_API_KEY (обязательна), SPANLENS_BASE_URL — адрес своего экземпляра (по умолчанию https://api.spanlens.io), SPANLENS_TIMEOUT_MS — тайм-аут вызова от 1 до 600000 мс (по умолчанию 30000).
Подключение к клиентам
Конфигурации из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"spanlens": {
"command": "npx",
"args": ["-y", "@spanlens/mcp-server"],
"env": { "SPANLENS_API_KEY": "sl_live_pub_..." }
}
}
}Для Cursor файл — ~/.cursor/mcp.json или .cursor/mcp.json в проекте. Для Claude Desktop — claude_desktop_config.json: на macOS в ~/Library/Application Support/Claude/, на Windows в %APPDATA%\Claude\. README приводит и YAML для Continue (~/.continue/config.yaml). Для своего экземпляра добавьте SPANLENS_BASE_URL в блок env.
Проверка
Перезагрузите IDE: агент должен увидеть семь инструментов. Спросите «сколько мы потратили на LLM за эту неделю?» — агент вызовет get_stats.
Примеры задач
Разбей расходы на LLM по моделям за последние 30 дней.Покажи 10 последних запросов к gpt-4o с ошибками и разбери трассировку самого дорогого агента за сегодня.Риски
- Утечка ключа. Ключ лежит открытым текстом в конфигурации IDE: его можно случайно закоммитить, синхронизировать или показать на экране. Поэтому сервер принимает только публичные ключи.
- Последствия утечки. Публичный ключ не может вызывать
/proxy/*и/ingest/*: сервер Spanlens отвечает 403. По README, в худшем случае посторонний увидит статистику использования. - Конфиденциальность. Тексты ошибок и данные пользователей из трассировок попадают в контекст агента.
Частые вопросы
Может ли сервер что-то изменить?
Нет, публичный ключ даёт доступ только на чтение.
Почему сервер не запускается?
Скорее всего, указан ключ полного доступа — нужен ключ sl_live_pub_….
Работает ли со своим Spanlens?
Да, задайте SPANLENS_BASE_URL.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Scrapling MCP Server
Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.
World Monitor
Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.
mcp
Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.
Netdata
Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.