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_ (чтение); с ключом полного доступа сервер не стартует.

Настройка клиентов

cursor
{
    "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-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники