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

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

Оглавление

• Обзор

• Функции

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

  • Команды в Claude Desktop

  • Результат в игле

• Установка

• Видео-объяснение

Related MCP server: MCP Web Research Server

Обзор

Сервер Needle MCP позволяет:

• Организуйте и храните документы для быстрого доступа.

• Выполняйте эффективный поиск с помощью большой языковой модели Клода.

• Полная интеграция с экосистемой Needle для расширенного управления документами.

Функции

• Управление документами: легко добавляйте и упорядочивайте документы на сервере.

• Поиск и извлечение: поиск на естественном языке на основе Claude для быстрых ответов.

• Простая интеграция: работает с коллекциями Claude Desktop и Needle.

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

Команды в Claude Desktop

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

1. Откройте Claude Desktop и подключитесь к серверу Needle MCP.

2. Используйте простые текстовые команды для поиска, извлечения или изменения документов.

3. Просматривайте результаты поиска, предоставленные Клодом, в удобном для пользователя интерфейсе.

Результат в игле

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

Объяснение видео на Youtube

Полное пошаговое руководство по использованию сервера Needle MCP с Claude и Claude Desktop можно посмотреть в этом видео на YouTube .

Установка

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

Чтобы автоматически установить Needle MCP для Claude Desktop через Smithery :

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

Ручная установка

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

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

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

brew install uv

3. Создайте claude_desktop_config.json:

   • Для MacOS: Откройте каталог ~/Library/Application Support/Claude/ и создайте внутри него файл

   • Для Windows: Откройте каталог %APPDATA%/Claude/ и создайте внутри него файл

4. Добавьте эту конфигурацию в claude_desktop_config.json:

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}

5. Получите свой ключ API Needle от needle.xyz

6. Обновите файл конфигурации:

   • Замените /path/to/needle-mcp на фактический путь к вашему репозиторию.

   • Добавьте свой ключ API Needle

7. Полностью закройте Claude и откройте его снова.

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

• «Создайте новую коллекцию под названием «Технические документы»»

• «Добавьте этот документ в коллекцию, которая находится по адресу https://needle-ai.com »

• «Поиск информации об ИИ в коллекции»

• «Список всех моих коллекций»

Поиск неисправностей

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

• Убедитесь, что UV установлен глобально (если нет, удалите с помощью pip uninstall uv и переустановите с помощью brew install uv )

• Или найдите UV-путь, с which uv , и замените "command": "uv" на полный путь

• Проверьте правильность вашего ключа API Needle

• Проверьте, соответствует ли путь needle-mcp в конфигурации фактическому расположению вашего репозитория.

Сброс конфигурации рабочего стола Клода

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

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

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

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

• На MacOS: rm -rf ~/Library/Application\ Support/Claude/*

• В Windows: удалите содержимое %APPDATA%/Claude/

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

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

4. Полностью закройте Claude Desktop (Command+Q на Mac) и перезапустите его.

5. Если вы все еще видите старые конфигурации:

• Проверьте наличие дополнительных файлов конфигурации в других местах.

• Попробуйте очистить кэш браузера, если используете веб-версию.

• Убедитесь, что файл конфигурации считывается из правильного места.