Создание агентов с помощью Needle MCP Server
Сервер MCP (Model Context Protocol) для управления документами и выполнения поиска с использованием Needle через настольное приложение Клода.
Оглавление
Обзор
Сервер Needle MCP позволяет:
- Организуйте и храните документы для быстрого доступа.
- Выполняйте эффективный поиск с помощью большой языковой модели Клода.
- Полная интеграция с экосистемой Needle для расширенного управления документами.
Функции
- Управление документами: легко добавляйте и упорядочивайте документы на сервере.
- Поиск и извлечение: поиск на естественном языке на основе Claude для быстрых ответов.
- Простая интеграция: работает с коллекциями Claude Desktop и Needle.
Использование
Команды в 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 в Терминале:
- Создайте 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
- Полностью закройте Claude Desktop (Command+Q на Mac) и перезапустите его.
- Если вы все еще видите старые конфигурации:
- Проверьте наличие дополнительных файлов конфигурации в других местах.
- Попробуйте очистить кэш браузера, если используете веб-версию.
- Убедитесь, что файл конфигурации считывается из правильного места.