# Ferret

MCP-сервер Ferret для Claude Code и Cursor, который подключает локальный домашний инвентарь к ИИ-ассистенту.

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

## Что делает

Ferret связывает ИИ-ассистентов с базой данных домашних вещей, чеков, гарантий и расходников, работая через протокол MCP по адресу `/mcp`. Сервер разворачивается в Docker-контейнере с SQLite, шифрованием загрузок и поддержкой нескольких домохозяйств. Для подключения нужен запущенный экземпляр Ferret, настроенный `PUBLIC_URL` и ключ доступа, созданный в настройках профиля.

## Требования
- Нужно: Docker
- Удалённый сервер: `https://{ferret_host}/mcp`

## Установка

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

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http ferret https://{ferret_host}/mcp
```

### Codex

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add ferret --url https://{ferret_host}/mcp
```

### Cursor

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ferret": {
            "url": "https://{ferret_host}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

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

### Gemini CLI

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http ferret https://{ferret_host}/mcp
```

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

## Примеры запросов агенту
- Где мы оставили туристическую палатку?
- Добавь новый блендер за 89 долларов на кухню
- Какой срок гарантии у посудомоечной машины?

## Похожие
- [EquipDash](https://affpapa.org/nevibecode/mcp/equipdash.md) — MCP-сервер · 4381 установка
- [lightspeed-ecom](https://affpapa.org/nevibecode/skills/lightspeed-ecom.md) — скилл · 207 установок
- [mcp-vtex](https://affpapa.org/nevibecode/mcp/mcp-vtex.md) — MCP-сервер · ★ 279 у репозитория
- [mcp-tiny](https://affpapa.org/nevibecode/mcp/mcp-tiny.md) — MCP-сервер · ★ 279 у репозитория
- [homebox-mcp](https://affpapa.org/nevibecode/mcp/homebox-mcp.md) — MCP-сервер · ★ 19 у репозитория
- [Crossmart](https://affpapa.org/nevibecode/mcp/crossmart.md) — MCP-сервер · ★ 2 у репозитория

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