# mcpspan

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

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

## Что делает

Агент может посмотреть частоту вызовов и ошибок, сравнить релизы, проверить задержки по клиентам и найти инструменты, которых серверу не хватает. Доступны также сведения о повторных вызовах и инструментах, показанных агентам, но оставшихся неиспользованными. Все инструменты только читают данные.

Подключить mcpspan можно по HTTP-адресу или как локально запускаемую команду через `npx`. Для командного способа нужен токен чтения и Node 20 или новее. Self-hosted установка требует mcpspan 0.9.0 или новее; для подключения по адресу нужна версия 0.13.0 или новее. При удалённом доступе к self-hosted установке требуется HTTPS: токен передаётся с каждым вопросом.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.mcpspan.com/mcp`
- Переменные окружения: `MCPSPAN_READ_TOKEN`, `MCPSPAN_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcpspan https://api.mcpspan.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env MCPSPAN_READ_TOKEN=<MCPSPAN_READ_TOKEN> --env MCPSPAN_URL=<MCPSPAN_URL> --transport stdio mcpspan-mcp -- npx -y mcpspan-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcpspan-mcp --url https://api.mcpspan.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add mcpspan-mcp --env MCPSPAN_READ_TOKEN=<MCPSPAN_READ_TOKEN> --env MCPSPAN_URL=<MCPSPAN_URL> -- npx -y mcpspan-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcpspan-mcp": {
            "url": "https://api.mcpspan.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcpspan-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcpspan-mcp"
            ],
            "env": {
                "MCPSPAN_READ_TOKEN": "<MCPSPAN_READ_TOKEN>",
                "MCPSPAN_URL": "<MCPSPAN_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcpspan-mcp": {
            "type": "http",
            "url": "https://api.mcpspan.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcpspan-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcpspan-mcp"
            ],
            "env": {
                "MCPSPAN_READ_TOKEN": "<MCPSPAN_READ_TOKEN>",
                "MCPSPAN_URL": "<MCPSPAN_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcpspan-mcp https://api.mcpspan.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e MCPSPAN_READ_TOKEN=<MCPSPAN_READ_TOKEN> -e MCPSPAN_URL=<MCPSPAN_URL> mcpspan-mcp npx -y mcpspan-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти MCP-инструменты с наибольшим числом сбоев
- сравнить показатели сервера между релизами
- узнать, какие инструменты агенты запрашивают, но сервер не поддерживает
- проверить ошибки и повторы вызовов в сессии
- сопоставить частоту ошибок у разных клиентов

## Примеры запросов агенту
- Покажи самые частые ошибки MCP-сервера за последние дни.
- Сравни релизы моего сервера и объясни, где изменились показатели.
- Какие инструменты агенты запрашивали, но не нашли на сервере?

## Похожие
- [Context7](https://affpapa.org/nevibecode/mcp/context7.md) — MCP-сервер · 5563 установки
- [Search Google Flights](https://affpapa.org/nevibecode/mcp/search-google-flights.md) — MCP-сервер · 2595 установок
- [Math-MCP](https://affpapa.org/nevibecode/mcp/math-mcp.md) — MCP-сервер · 5958 установок
- [pipeworx gateway](https://affpapa.org/nevibecode/mcp/pipeworx-gateway.md) — MCP-сервер · 419019 установок
- [SparkForge](https://affpapa.org/nevibecode/mcp/sparkforge.md) — MCP-сервер · 219896 установок
- [OpenWebSearch](https://affpapa.org/nevibecode/mcp/openwebsearch.md) — MCP-сервер · 494 установки

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