# Hashgrid DNA (local)

Локальный MCP-сервер ищет по тексту и изображениям, а оценки результатов помогают улучшать последующую выдачу. Подключите его, если агенту нужен поиск по локальному индексу.

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

## Что делает

Hashgrid DNA (local) добавляет элементы в индекс, ищет подходящие по запросу и принимает оценку результата. Поиск можно сузить префиксом ключа. Для изображений нужен эмбеддер, который их поддерживает; текстовый запрос тоже может находить изображения.

Содержимое и эмбеддинги обрабатываются локально, а DNA получает только векторы. По умолчанию локальный эмбеддер работает на CPU; для него нужен пакет `hashgrid[local]`. Если выбрать OpenAI или Voyage, содержимое отправляется выбранному провайдеру, поэтому для такого режима нужны соответствующие ключи API. Это важно учитывать, если проект не должен передавать данные внешнему сервису.

Сервер работает через stdio. В Claude Code его можно добавить командой ниже; переменные окружения позволяют задать ключ DNA, эмбеддер и путь к индексу. Без ключа сервер может создать сетку и сохранить ключ локально.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `HASHGRID_API_KEY`, `HASHGRID_EMBEDDER`, `OPENAI_API_KEY`, `VOYAGE_API_KEY`, `HASHGRID_INDEX` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env HASHGRID_API_KEY=<HASHGRID_API_KEY> --env HASHGRID_EMBEDDER=<HASHGRID_EMBEDDER> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env VOYAGE_API_KEY=<VOYAGE_API_KEY> --env HASHGRID_INDEX=<HASHGRID_INDEX> --transport stdio hashgrid-dna-local -- uvx hashgrid
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hashgrid <команда>

### Codex

**Командой платформы**
```bash
codex mcp add hashgrid-dna-local --env HASHGRID_API_KEY=<HASHGRID_API_KEY> --env HASHGRID_EMBEDDER=<HASHGRID_EMBEDDER> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env VOYAGE_API_KEY=<VOYAGE_API_KEY> --env HASHGRID_INDEX=<HASHGRID_INDEX> -- uvx hashgrid
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hashgrid <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hashgrid-dna-local": {
            "command": "uvx",
            "args": [
                "hashgrid"
            ],
            "env": {
                "HASHGRID_API_KEY": "<HASHGRID_API_KEY>",
                "HASHGRID_EMBEDDER": "<HASHGRID_EMBEDDER>",
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
                "HASHGRID_INDEX": "<HASHGRID_INDEX>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hashgrid <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hashgrid-dna-local": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "hashgrid"
            ],
            "env": {
                "HASHGRID_API_KEY": "<HASHGRID_API_KEY>",
                "HASHGRID_EMBEDDER": "<HASHGRID_EMBEDDER>",
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
                "HASHGRID_INDEX": "<HASHGRID_INDEX>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hashgrid <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e HASHGRID_API_KEY=<HASHGRID_API_KEY> -e HASHGRID_EMBEDDER=<HASHGRID_EMBEDDER> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e VOYAGE_API_KEY=<VOYAGE_API_KEY> -e HASHGRID_INDEX=<HASHGRID_INDEX> hashgrid-dna-local uvx hashgrid
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hashgrid <команда>

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

## Примеры запросов агенту
- Найди в индексе материалы о настройке сборки проекта.
- Добавь изображение `photos/beach.jpg` в локальный индекс.
- Оцени первый результат как подходящий, а второй как неподходящий.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89899

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