Needle · needle-ai — MCP-сервер для Claude Code: что делает и как настроить
Подключает сервис Needle к ИИ-ассистентам для семантического поиска и работы с документами вроде PDF, DOCX и XLSX.
лицензия не указана обновлён 2026-10-29
Открыть на GitHubЧто делает Needle
Сервер даёт модели доступ к поисковому движку Needle через протокол MCP. Ассистент может создавать коллекции, загружать веб-страницы или локальные файлы и извлекать фрагменты текста под конкретный поисковый запрос.
Разработчики предлагают использовать удалённый адрес https://mcp.needle.app/mcp, поэтому держать локальный сервис необязательно. Для запуска на собственной машине в репозитории предусмотрены сборка через uv на Python и готовый образ Docker.
Для любых операций с сервисом потребуется действующий ключ NEEDLE_API_KEY. Без авторизационного токена сервер отклонит запросы к удалённому API.
Какие задачи решает
- находить данные внутри файлов PDF, DOCX и таблиц XLSX
- создавать тематические коллекции документов для контекста модели
- добавлять страницы по веб-ссылкам в базу знаний проекта
- передавать релевантные цитаты в диалог с ассистентом
Примеры запросов агенту
- Создай новую коллекцию с названием Документация
- Добавь ссылку https://needle.app в текущую коллекцию
- Найди в моих коллекциях упоминания архитектуры модели
Как установить Needle
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Needle
Как подключить Needle к клиенту?
Рекомендуется прописать удалённый сервер через утилиту npx mcp-remote https://mcp.needle.app/mcp --header "Authorization:Bearer ${NEEDLE_API_KEY}" и передать ключ NEEDLE_API_KEY в переменных окружения конфигурационного файла.
Что делает MCP-сервер Needle?
Он связывает модель с платформой Needle, превращая документы пользователя в источник контекста для семантического поиска.
Какой сетевой эндпоинт лучше выбрать?
Используйте потоковый HTTP-эндпоинт https://mcp.needle.app/mcp, так как поддержка SSE в последних версиях спецификации MCP считается устаревшей.
Похожие MCP-серверы
Все MCP-серверы по теме «ИИ и ML» →Сначала — Needle от других авторов.