# genaispanmapper-mcp

Удалённый MCP-сервер для приведения спанов OpenTelemetry к единой схеме. Помогает инженерам платформы выявлять недостающие атрибуты провайдеров и готовить данные для дашбордов.

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

## Что делает

Сервер работает с телеметрией генеративного ИИ и приводит данные трейсинга OpenTelemetry к согласованному виду. Он берёт разнородные параметры провайдеров и преобразует их в стандартизированные структуры JSON, чтобы метрики в аналитике не расходились.

В набор входят пять инструментов для агента: `map_genai_span_fields`, `normalize_provider_attributes`, `detect_missing_genai_attributes`, `issue_mapping_receipt` и `export_observability_schema`. С их помощью Claude Code или Cursor могут находить пропущенные поля в телеметрии, валидировать правила провайдеров и выгружать схемы для систем наблюдаемости.

Это платный удалённый сервис, доступный по адресу `https://genaispanmapper.clauxel.com/mcp`. В публичном репозитории нет исходного кода самого маппера, поэтому без обращения к внешнему эндпоинту сервер работать не будет.

## Требования
- Удалённый сервер: `https://genaispanmapper.clauxel.com/mcp`

## Установка

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

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

### Codex

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

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "genaispanmapper-mcp": {
            "url": "https://genaispanmapper.clauxel.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "genaispanmapper-mcp": {
            "type": "http",
            "url": "https://genaispanmapper.clauxel.com/mcp"
        }
    }
}
```

### Gemini CLI

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

## Когда брать
- Привести разнородные спаны генеративного ИИ к стандарту OpenTelemetry
- Найти недостающие атрибуты провайдеров в трейсах
- Сгенерировать квитанцию маппинга для аудита телеметрии
- Экспортировать схему спанов для аналитических дашбордов

## Примеры запросов агенту
- Проверь этот спан вызова LLM через `detect_missing_genai_attributes` и покажи, каких полей не хватает.
- Нормализуй атрибуты модели в трейсе с помощью `normalize_provider_attributes`.
- Сформируй схему для системы мониторинга через инструмент `export_observability_schema`.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23654
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17191
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12110

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