# FreightUtils MCP Server

Справочник и калькулятор для логистики: агент считает объёмный вес, LDM, пошлины и проверяет опасные грузы по ADR. Каждый ответ со ссылкой на источник.

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

## Что делает

Сервер даёт агенту 25 инструментов для расчётов и справок по автоперевозкам, авиа и морю. Среди них `ldm_calculator`, `cbm_calculator`, `chargeable_weight_calculator`, `container_lookup`, `unit_converter`, `consignment_calculator` и `emissions_calculator` для CO2e по методу ISO 14083 / GLEC на открытых факторах DEFRA, EPA и ADEME.

Отдельный блок — опасные грузы и таможня. `adr_lookup` ищет по 2 939 записям UNECE ADR 2025, `adr_exemption_calculator` проверяет малое количество по 1.1.3.6, `adr_lq_eq_check` — LQ и EQ. Для тарифа есть `hs_code_lookup` по 6 940 кодам HS 2022, `uk_duty_calculator` на живых данных GOV.UK Trade Tariff и `incoterms_lookup`. Справочные инструменты закрывают авиакомпании, аэропорты, UN/LOCODE и типы ULD. `validate` находит в тексте номера контейнеров по ISO 6346, AWB и IMO и проверяет контрольные разряды.

Ответы детерминированные, с блоком `_source` — орган, редакция, лицензия и статус проверки. Это справка, а не подача документов и не юридическая консультация: чистая проверка `ics2_check` не означает принятия ENS, а `validate` делает только структурную проверку контрольного разряда. Анонимно доступно 25 запросов в сутки на IP, поэтому для регулярной работы понадобится ключ в переменной `FREIGHTUTILS_API_KEY` — пакет читает её из `process.env` и добавляет `Authorization: Bearer <key>` к запросам.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://www.freightutils.com/api/mcp`

## Установка

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

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

2. **Командой платформы**
```bash
claude mcp add freightutils-mcp-server -- npx -y freightutils-mcp
```

### Codex

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

2. **Командой платформы**
```bash
codex mcp add freightutils-mcp-server -- npx -y freightutils-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freightutils-mcp-server": {
            "url": "https://www.freightutils.com/api/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freightutils-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "freightutils-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "freightutils-mcp-server": {
            "type": "http",
            "url": "https://www.freightutils.com/api/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "freightutils-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "freightutils-mcp"
            ]
        }
    }
}
```

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini mcp add freightutils-mcp-server npx -y freightutils-mcp
```

## Когда брать
- посчитать загрузочные метры для европейского или американского трейлера
- перевести объёмный вес в оплачиваемый для авиаперевозки
- проверить, попадает ли партия под исключение по ADR 1.1.3.6
- найти код ТН ВЭД и посчитать пошлину и НДС при импорте в Великобританию
- выловить в строке бронирования номера контейнеров и AWB с ошибкой в контрольном разряде

## Примеры запросов агенту
- Посчитай оплачиваемый вес для коробки 120×80×100 см и 45 кг, рейс авиа
- Проверь по ADR, можно ли везти UN 1789 малым количеством
- Найди код HS 2022 для кофемолки и посчитай пошлину при ввозе в Великобританию

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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