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

значок кузнеца

Скриншот функции - Клод

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

Обзор

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

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

Функции

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

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

Команды в Claude Desktop

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

Использование команд в Claude Desktop

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

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

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

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

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

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

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

brew install uv

Создайте claude_desktop_config.json:
- Для MacOS: Откройте каталог ~/Library/Application Support/Claude/ и создайте внутри него файл
- Для Windows: Откройте каталог %APPDATA%/Claude/ и создайте внутри него файл
Добавьте эту конфигурацию в 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" } } } }

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

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

«Создайте новую коллекцию под названием «Технические документы»»
«Добавьте этот документ в коллекцию, которая находится по адресу https://needle-ai.com »
«Поиск информации об ИИ в коллекции»
«Список всех моих коллекций»

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

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

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

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

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

Найти все файлы конфигурации 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_mcp": { "command": "uv", "args": [ "--directory", "/path/to/needle-mcp", "run", "needle-mcp" ], "env": { "NEEDLE_API_KEY": "your_needle_api_key" } } } } EOL