Hashgrid DNA (local) — MCP-сервер для Claude Code: поиск и установка
Локальный MCP-сервер ищет по тексту и изображениям, а оценки результатов помогают улучшать последующую выдачу. Подключите его, если агенту нужен поиск по локальному индексу.
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Что делает Hashgrid DNA (local)
Hashgrid DNA (local) добавляет элементы в индекс, ищет подходящие по запросу и принимает оценку результата. Поиск можно сузить префиксом ключа. Для изображений нужен эмбеддер, который их поддерживает; текстовый запрос тоже может находить изображения.
Содержимое и эмбеддинги обрабатываются локально, а DNA получает только векторы. По умолчанию локальный эмбеддер работает на CPU; для него нужен пакет hashgrid[local]. Если выбрать OpenAI или Voyage, содержимое отправляется выбранному провайдеру, поэтому для такого режима нужны соответствующие ключи API. Это важно учитывать, если проект не должен передавать данные внешнему сервису.
Сервер работает через stdio. В Claude Code его можно добавить командой ниже; переменные окружения позволяют задать ключ DNA, эмбеддер и путь к индексу. Без ключа сервер может создать сетку и сохранить ключ локально.
Какие задачи решает
- найти элементы локального индекса по текстовому запросу
- искать изображения по тексту или другому изображению
- сузить поиск по префиксу ключа
- оценить результаты, чтобы повлиять на следующие выдачи
Примеры запросов агенту
- Найди в индексе материалы о настройке сборки проекта.
- Добавь изображение
photos/beach.jpgв локальный индекс. - Оцени первый результат как подходящий, а второй как неподходящий.
Как установить Hashgrid DNA (local)
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hashgrid DNA (local)
Как установить Hashgrid DNA (local) в Claude Code?
Выполните `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`. Переменные задают ключ и настройки эмбеддера и индекса.
Что делает Hashgrid DNA (local)?
Он индексирует текст и изображения локально, ищет по ним и передаёт DNA векторы вместо содержимого. Оценки результатов влияют на ранжирование последующих поисков.
Нужен ли ключ API для локального поиска?
Для локальных эмбеддеров из hashgrid[local] аккаунт не нужен. Ключ сетки используется для работы с DNA; без него сервер может создать сетку и сохранить ключ в локальном индексе.
