# mcp-server

MCP-сервер даёт агенту доступ к данным наблюдаемости Spanlens: расходам, трассам, ошибкам и аномалиям. Подходит для анализа LLM-вызовов из IDE.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Автор: spanlens
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/spanlens/Spanlens/tree/HEAD/packages/mcp-server
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/spanlens-mcp-server

## Что делает

\`mcp-server` подключает агент к рабочему пространству Spanlens через MCP. Он предоставляет семь инструментов для статистики расходов и токенов, поиска отдельных запросов, списка трасс и просмотра дерева спанов. Также сервер находит аномалии, предлагает замены моделей и показывает расходы по конечным пользователям.

Для запуска нужен ключ `sl_live_pub_*` в переменной `SPANLENS_API_KEY`; сервер проверяет его область доступа при старте. Полный ключ `sl_live_*` он отклоняет, а публичный ключ остаётся доступным только для чтения. Подключение запускается через `npx -y @spanlens/mcp-server`, а для собственного развёртывания Spanlens можно задать `SPANLENS_BASE_URL`.

Запросы можно группировать по модели или провайдеру, фильтровать по статусу, пользователю и времени. Без публичного ключа сервер не запустится, поэтому секрет для IDE нужно создать заранее.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `SPANLENS_API_KEY`, `SPANLENS_BASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env SPANLENS_API_KEY=<SPANLENS_API_KEY> --env SPANLENS_BASE_URL=<SPANLENS_BASE_URL> --transport stdio mcp-server -- npx -y @spanlens/mcp-server
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-server --env SPANLENS_API_KEY=<SPANLENS_API_KEY> --env SPANLENS_BASE_URL=<SPANLENS_BASE_URL> -- npx -y @spanlens/mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@spanlens/mcp-server"
            ],
            "env": {
                "SPANLENS_API_KEY": "<SPANLENS_API_KEY>",
                "SPANLENS_BASE_URL": "<SPANLENS_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@spanlens/mcp-server"
            ],
            "env": {
                "SPANLENS_API_KEY": "<SPANLENS_API_KEY>",
                "SPANLENS_BASE_URL": "<SPANLENS_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SPANLENS_API_KEY=<SPANLENS_API_KEY> -e SPANLENS_BASE_URL=<SPANLENS_BASE_URL> mcp-server npx -y @spanlens/mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить расходы LLM по моделям и провайдерам
- найти аномалии в стоимости и задержке
- просмотреть ошибки отдельных LLM-запросов
- разобрать дерево спанов агентского запуска
- сравнить модели по потенциальной экономии

## Примеры запросов агенту
- Покажи расходы на LLM за эту неделю и сгруппируй их по провайдеру.
- Найди аномалии в стоимости или задержке за последний период.
- Покажи последние ошибочные вызовы модели `gpt-4o` и разберись с трассой `abc123…`.

## Похожие
- [arize-link](https://affpapa.org/nevibecode/skills/arize-link.md) — скилл · 1100 установок
- [opik](https://affpapa.org/nevibecode/skills/opik.md) — скилл · 528 установок
- [agent-observability-replay-trace](https://affpapa.org/nevibecode/skills/agent-observability-replay-trace.md) — скилл · 399 установок
- [Model Ledger](https://affpapa.org/nevibecode/mcp/model-ledger.md) — MCP-сервер · ★ 17
- [hot-memory-mcp](https://affpapa.org/nevibecode/mcp/hot-memory-mcp.md) — MCP-сервер · ★ 14
- [kairn](https://affpapa.org/nevibecode/mcp/kairn.md) — MCP-сервер · ★ 13

## Другие версии с тем же именем
- [mcp-server · heyputer](https://affpapa.org/nevibecode/mcp/mcp-server.md) — ★ 43902
- [mcp-server · mapbox](https://affpapa.org/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md