# Pirate Ship by Cotlet

MCP-сервер связывает ИИ-агента с Pirate Ship для расчёта почтовых тарифов, подготовки этикеток и отслеживания отправлений через браузерную сессию пользователя.

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

## Что делает

Сервер открывает агенту доступ к операциям Pirate Ship через MCP, а также предоставляет REST API и Python-интерфейс. С его помощью можно получать тарифы USPS и UPS, создавать черновики почтовых этикеток, работать с отправлениями и отслеживанием, формировать SCAN Forms и отчёты. В комплекте есть готовые Python-скрипты.

Для работы нужен Python 3.11 или новее, Google Chrome 144+ с авторизацией в Pirate Ship и аккаунт с адресом отправителя. Команда `pirate-ship-mcp connect` получает cookies через Chrome DevTools Protocol и сохраняет их в пользовательском конфигурационном файле; пароль она не читает. Сервер использует операции GraphQL веб-приложения Pirate Ship, поэтому изменения запросов на стороне сервиса могут нарушить работу отдельных функций до обновления их идентификаторов.

Проект рассчитан на самостоятельный запуск и некоммерческое использование. Функции, которые списывают или возвращают деньги, в эту версию не входят. Покупка этикеток выполняется непосредственно в Pirate Ship, а для неё нужен баланс аккаунта или платёжный метод. Сервер можно подключить к Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed и Gemini CLI.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://cotlet.dev/mcp/v1/pirate-ship/connect`

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http pirate-ship https://cotlet.dev/mcp/v1/pirate-ship/connect
```

2. **Командой платформы**
```bash
claude mcp add pirate-ship-by-cotlet -- uvx pirate-ship-api-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pirate-ship-api-mcp <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add pirate-ship-by-cotlet --url https://cotlet.dev/mcp/v1/pirate-ship/connect
```

2. **Командой платформы**
```bash
codex mcp add pirate-ship-by-cotlet -- uvx pirate-ship-api-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pirate-ship-api-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pirate-ship-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/pirate-ship/connect"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pirate-ship-by-cotlet": {
            "command": "uvx",
            "args": [
                "pirate-ship-api-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pirate-ship-api-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pirate-ship-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/pirate-ship/connect"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pirate-ship-by-cotlet": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "pirate-ship-api-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pirate-ship-api-mcp <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http pirate-ship-by-cotlet https://cotlet.dev/mcp/v1/pirate-ship/connect
```

2. **Командой платформы**
```bash
gemini mcp add pirate-ship-by-cotlet uvx pirate-ship-api-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from pirate-ship-api-mcp <команда>

## Когда брать
- Рассчитать тарифы USPS и UPS по параметрам отправления
- Подготовить черновик почтовой этикетки
- Получить сведения о статусе посылки
- Сформировать SCAN Forms для отправлений
- Загрузить отчёты по доставкам и заказам

## Примеры запросов агенту
- Рассчитай тарифы USPS и UPS для отправления весом 16 унций с индексом получателя 10001.
- Подготовь черновик почтовой этикетки для этого отправления.
- Проверь статус посылки и подготовь SCAN Forms для отправлений.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16730
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24271
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7548

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