Skip to main content
Glama
Sign In
deenesjakoruzh

Needle MCP Server

Official
by needle-ai
GitHub
Python
MIT License
39
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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

Оглавление

Обзор

Сервер 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
  1. Установите UV глобально с помощью Homebrew в Терминале:
brew install uv
  1. Создайте claude_desktop_config.json:
    • Для MacOS: Откройте каталог ~/Library/Application Support/Claude/ и создайте внутри него файл
    • Для Windows: Откройте каталог %APPDATA%/Claude/ и создайте внутри него файл
  2. Добавьте эту конфигурацию в 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" } } } }
  1. Получите свой ключ API Needle от needle.xyz
  2. Обновите файл конфигурации:
    • Замените /path/to/needle-mcp на фактический путь к вашему репозиторию.
    • Добавьте свой ключ API Needle
  3. Полностью закройте 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
  1. Удалить все данные Claude Desktop:
  • На MacOS: rm -rf ~/Library/Application\ Support/Claude/*
  • В Windows: удалите содержимое %APPDATA%/Claude/
  1. Создайте новую конфигурацию только с 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
  1. Полностью закройте Claude Desktop (Command+Q на Mac) и перезапустите его.
  2. Если вы все еще видите старые конфигурации:
  • Проверьте наличие дополнительных файлов конфигурации в других местах.
  • Попробуйте очистить кэш браузера, если используете веб-версию.
  • Убедитесь, что файл конфигурации считывается из правильного места.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Сервер, позволяющий пользователям управлять документами и выполнять поиск с помощью Claude, используя Needle через приложение Claude Desktop.

  1. Оглавление
    1. Обзор
      1. Функции
        1. Использование
          1. Команды в Claude Desktop
          2. Результат в игле
        2. Объяснение видео на Youtube
          1. Установка
            1. Установка через Smithery
            2. Ручная установка
          2. Примеры использования
            1. Поиск неисправностей
              1. Сброс конфигурации рабочего стола Клода

            Related Resources

            Related MCP Servers

            • Perplexity MCP Server

              jsonallen
              A
              security
              A
              license
              A
              quality
              A server facilitating web search functionality by utilizing Perplexity AI's API, designed to integrate with the Claude desktop client for enhanced search queries.
              Last updated -
              1
              94
              Python
              MIT License
              • Apple

            • MCP Alchemy

              runekaagaard
              -
              security
              A
              license
              -
              quality
              Connects Claude Desktop directly to databases, allowing it to explore database structures, write SQL queries, analyze datasets, and create reports through an API layer with tools for table exploration and query execution.
              Last updated -
              182
              Python
              Mozilla Public License 2.0
              • Apple

            • Claude Desktop API MCP

              mlobo2012
              A
              security
              F
              license
              A
              quality
              A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
              Last updated -
              1
              5
              Python
              • Apple

            • MCP Web Research Server

              jevy
              -
              security
              A
              license
              -
              quality
              A server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.
              Last updated -
              854
              MIT License
              • Apple

            View all related MCP servers

            New MCP Servers

            ID: 5jw1t7hur2