Needle MCP Server

официальный

Готовый к использованию RAG для поиска и извлечения данных из ваших собственных документов.

Документация

Создание агентов с помощью Needle MCP Server

Screenshot of Feature - Claude

MCP (Model Context Protocol) сервер для управления документами и выполнения поиска с использованием Needle через десктопное приложение Claude.

Содержание

Обзор
Возможности
Использование
- Команды в Claude Desktop
- Результат в Needle
Установка
Видеообъяснение

Обзор

Needle MCP Server позволяет:

Организовывать и хранить документы для быстрого поиска.
Выполнять мощный поиск с помощью большой языковой модели Claude.
Бесшовно интегрироваться с экосистемой Needle для продвинутого управления документами.

MCP (Model Context Protocol) стандартизирует способ подключения LLM к внешним источникам данных. Вы можете использовать Needle MCP Server, чтобы легко включить инструменты семантического поиска в ваши AI-приложения, делая данные, скрытые в PDF, DOCX, XLSX и других файлах, мгновенно доступными для LLM.

Мы рекомендуем использовать наш удаленный MCP-сервер для наилучшего опыта — локальная настройка не требуется.

Возможности

Управление документами: Легко добавляйте и организуйте документы на сервере.
Поиск и извлечение: Поиск на естественном языке на базе Claude для быстрых ответов.
Простая интеграция: Работает с Claude Desktop и коллекциями Needle.

Использование

Команды в Claude Desktop

Ниже приведен пример того, как команды могут использоваться в Claude Desktop для взаимодействия с сервером:

Using commands in Claude Desktop

Откройте Claude Desktop и подключитесь к Needle MCP Server.
Используйте простые текстовые команды для поиска, извлечения или изменения документов.
Просматривайте результаты поиска, возвращаемые Claude в удобном интерфейсе.

Результат в Needle

https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c

Видеообъяснение на Youtube

Для полного пошагового руководства по использованию Needle MCP Server с Claude и Claude Desktop посмотрите это видеообъяснение на YouTube.

Установка

1. Удаленный MCP-сервер (рекомендуется)

Конфигурация Claude Desktop

Создайте или обновите ваш конфигурационный файл:

Для MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Для Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:Bearer ${NEEDLE_API_KEY}"
      ],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Конфигурация Cursor

Создайте или обновите .cursor/mcp.json:

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:${NEEDLE_AUTH_HEADER}"
      ],
      "env": {
        "NEEDLE_AUTH_HEADER": "Bearer <your-needle-api-key>"
      }
    }
  }
}

Получите ваш API-ключ в настройках Needle.

Мы предоставляем две конечные точки:

Streamable HTTP: https://mcp.needle.app/mcp (рекомендуется)
SSE: https://mcp.needle.app/sse

Примечание: MCP объявил конечные точки SSE устаревшими в последней спецификации, поэтому новым клиентам следует отдавать предпочтение конечной точке Streamable HTTP.

2. Локальная установка

Клонируйте репозиторий:

git clone https://github.com/needle-ai/needle-mcp.git

Установите UV глобально с помощью Homebrew:

brew install uv

Создайте ваш конфигурационный файл:
- Для MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Для Windows: %APPDATA%/Claude/claude_desktop_config.json

Конфигурация Claude Desktop

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Конфигурация Cursor

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Замените /path/to/needle-mcp на фактический путь к вашему репозиторию
Добавьте ваш API-ключ Needle
Перезапустите Claude Desktop

Установка через Smithery

npx -y @smithery/cli install needle-mcp --client claude

3. Установка через Docker

Клонируйте и соберите:

git clone https://github.com/needle-ai/needle-mcp.git
cd needle-mcp
docker build -t needle-mcp .

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "needle": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Перезапустите Claude Desktop

Примеры использования

"Создать новую коллекцию с названием 'Техническая документация'"
"Добавить этот документ в коллекцию, а именно https://needle.app"
"Найти в коллекции информацию об искусственном интеллекте"
"Показать все мои коллекции"

Устранение неполадок

Если не работает:

Убедитесь, что uv установлен глобально (если нет, удалите с помощью pip uninstall uv и переустановите с помощью brew install uv)
Или найдите путь к uv с помощью which uv и замените "command": "uv" на полный путь
Проверьте правильность вашего API-ключа Needle
Проверьте, соответствует ли путь needle-mcp в конфигурации фактическому расположению вашего репозитория

Сброс конфигурации Claude Desktop

Если вы видите старые конфигурации или интеграция не работает:

Найдите все конфигурационные файлы Claude Desktop:

find / -name "claude_desktop_config.json" 2>/dev/null

Удалите все данные Claude Desktop:

На MacOS: rm -rf ~/Library/Application\ Support/Claude/*
На Windows: Удалите содержимое %APPDATA%/Claude/

Создайте новую конфигурацию только с Needle:

mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
<< 'EOL'
{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL

Полностью закройте Claude Desktop (Command+Q на Mac) и перезапустите его
Если вы все еще видите старые конфигурации:

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