Skip to main content
Glama
Needle MCP Server

Needle MCP Server

Official
by needle-ai

Erstellen Sie Agenten mit dem Needle MCP Server

Schmiedeabzeichen

Screenshot der Funktion – Claude

MCP-Server (Model Context Protocol) zum Verwalten von Dokumenten und Durchführen von Suchvorgängen mit Needle über die Desktop-Anwendung von Claude.

Inhaltsverzeichnis


Related MCP server: Documentation MCP Server

Überblick

Mit dem Needle MCP-Server können Sie:

  • Organisieren und speichern Sie Dokumente für den schnellen Zugriff.

  • Führen Sie leistungsstarke Suchvorgänge über Claudes großes Sprachmodell durch.

  • Nahtlose Integration in das Needle-Ökosystem für erweitertes Dokumentenmanagement.


Merkmale

  • Dokumentenverwaltung: Einfaches Hinzufügen und Organisieren von Dokumenten auf dem Server.

  • Suchen und Abrufen: Claude-basierte Suche in natürlicher Sprache für schnelle Antworten.

  • Einfache Integration: Funktioniert mit den Sammlungen Claude Desktop und Needle.


Verwendung

Befehle in Claude Desktop

Nachfolgend sehen Sie ein Beispiel, wie die Befehle in Claude Desktop zur Interaktion mit dem Server verwendet werden können:

Verwenden von Befehlen in Claude Desktop

  1. Öffnen Sie Claude Desktop und stellen Sie eine Verbindung zum Needle MCP-Server her.

  2. Verwenden Sie einfache Textbefehle zum Suchen, Abrufen oder Ändern von Dokumenten.

  3. Überprüfen Sie die von Claude zurückgegebenen Suchergebnisse in einer benutzerfreundlichen Oberfläche.

Ergebnis in Nadel

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


Youtube-Video-Erklärung

Eine vollständige Anleitung zur Verwendung des Needle MCP-Servers mit Claude und Claude Desktop finden Sie in diesem Erklärvideo auf YouTube .


Installation

Installation über Smithery

So installieren Sie Needle MCP für Claude Desktop automatisch über Smithery :

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

Manuelle Installation

  1. Klonen Sie das Repository:

git clone https://github.com/yourusername/needle-mcp.git
  1. Installieren Sie UV global mit Homebrew im Terminal:

brew install uv
  1. Erstellen Sie claude_desktop_config.json:

    • Für MacOS: Öffnen Sie das Verzeichnis ~/Library/Application Support/Claude/ und erstellen Sie die Datei darin

    • Für Windows: Öffnen Sie das Verzeichnis %APPDATA%/Claude/ und erstellen Sie die Datei darin

  2. Fügen Sie diese Konfiguration zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
  1. Holen Sie sich Ihren Needle-API-Schlüssel von needle.xyz

  2. Aktualisieren Sie die Konfigurationsdatei:

    • Ersetzen Sie /path/to/needle-mcp durch Ihren tatsächlichen Repository-Pfad

    • Fügen Sie Ihren Needle-API-Schlüssel hinzu

  3. Beenden Sie Claude vollständig und öffnen Sie es erneut

Anwendungsbeispiele

  • „Erstellen Sie eine neue Sammlung mit dem Namen ‚Technische Dokumente‘.“

  • „Fügen Sie dieses Dokument der Sammlung https://needle-ai.com hinzu.“

  • „Durchsuchen Sie die Sammlung nach Informationen zum Thema KI“

  • "Alle meine Sammlungen auflisten"

Fehlerbehebung

Falls es nicht funktioniert:

  • Stellen Sie sicher, dass UV global installiert ist (wenn nicht, deinstallieren Sie es mit pip uninstall uv und installieren Sie es erneut mit brew install uv ).

  • Oder suchen Sie den UV-Pfad mit which uv und ersetzen Sie "command": "uv" durch den vollständigen Pfad

  • Überprüfen Sie, ob Ihr Needle-API-Schlüssel korrekt ist

  • Überprüfen Sie, ob der needle-mcp-Pfad in der Konfiguration mit Ihrem tatsächlichen Repository-Speicherort übereinstimmt

Claude Desktop-Konfiguration zurücksetzen

Wenn Sie alte Konfigurationen sehen oder die Integration nicht funktioniert:

  1. Finden Sie alle Claude Desktop-Konfigurationsdateien:

find / -name "claude_desktop_config.json" 2>/dev/null
  1. Entfernen Sie alle Claude Desktop-Daten:

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

  • Unter Windows: Löschen Sie den Inhalt von %APPDATA%/Claude/

  1. Erstellen Sie eine neue Konfiguration nur mit 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. Beenden Sie Claude Desktop vollständig (Befehl+Q auf dem Mac) und starten Sie es neu

  2. Wenn Sie immer noch alte Konfigurationen sehen:

  • Suchen Sie an anderen Speicherorten nach zusätzlichen Konfigurationsdateien

  • Versuchen Sie, den Browser-Cache zu leeren, wenn Sie die Webversion verwenden

  • Überprüfen Sie, ob die Konfigurationsdatei vom richtigen Speicherort gelesen wird.

Available Tools

7 tools
needle_add_fileAInspect

Add a new document to a Needle collection by providing a URL for download. Supports multiple file formats including: - PDF documents - Microsoft Word files (DOC, DOCX) - Plain text files (TXT) - Web pages (HTML)

        The document will be:
        1. Downloaded from the provided URL
        2. Processed for text extraction
        3. Indexed for semantic search
        
        Use this tool when you need to:
        - Add new documents to a collection
        - Make documents searchable
        - Expand your knowledge base
        
        Important: Documents require processing time before they're searchable.
        Check processing status using needle_list_files before searching new content.

Inputs: collection_id (required), name (required), url (required).

needle_create_collectionAInspect

Create a new document collection in Needle for organizing and searching documents. A collection acts as a container for related documents and enables semantic search across its contents. Use this tool when you need to: - Start a new document organization - Group related documents together - Set up a searchable document repository Returns a collection ID that's required for subsequent operations. Choose a descriptive name that reflects the collection's purpose for better organization.

Inputs: name (required).

needle_get_collection_detailsAInspect

Fetch comprehensive metadata about a specific Needle collection. Provides detailed information about the collection's configuration, creation date, and current status. Use this tool when you need to: - Verify a collection's existence and configuration - Check collection metadata before operations - Get creation date and other attributes Requires a valid collection ID and returns detailed collection metadata. Will error if collection doesn't exist.

Inputs: collection_id (required).

needle_get_collection_statsAInspect

Retrieve detailed statistical information about a Needle collection's contents and status. Provides metrics including: - Total number of documents - Processing status of documents - Storage usage and limits - Index status and health Use this tool to: - Monitor collection size and growth - Verify processing completion - Check collection health before operations Essential for ensuring collection readiness before performing searches.

Inputs: collection_id (required).

needle_list_collectionsAInspect

List Needle collections. Returns maximum of 20 results. Get more results by increasing the offset. Returns detailed information including collection IDs, names, and creation dates. Use this tool when you need to: - Get an overview of available document collections - Find collection IDs for subsequent operations - Verify collection existence before performing operations The response includes metadata that's required for other Needle operations.

Inputs: offset.

needle_list_filesAInspect

List all documents stored within a specific Needle collection with their current status. Returns detailed information about each file including: - File ID and name - Processing status (pending, processing, complete, error) - Upload date and metadata Use this tool when you need to: - Inventory available documents - Check processing status of uploads - Get file IDs for reference - Verify document availability before searching Essential for monitoring document processing completion before performing searches.

Inputs: collection_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: collection management (create, list, get details, get stats), file management (add, list), and search. The descriptions explicitly differentiate their functions, such as needle_get_collection_details for metadata vs. needle_get_collection_stats for metrics, eliminating any ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with the 'needle_' prefix, using snake_case throughout (e.g., needle_create_collection, needle_list_files). This predictable naming scheme makes it easy for agents to understand and select tools based on their actions and targets.

    Tool Count5/5

    With 7 tools, the server is well-scoped for document management and search, covering essential operations like collection CRUD, file addition, status monitoring, and semantic search. Each tool serves a clear purpose without redundancy, fitting the domain's needs efficiently.

    Completeness4/5

    The toolset provides strong coverage for core document management workflows, including collection lifecycle, file processing, and search. A minor gap exists in file deletion or update capabilities, which could limit full CRUD operations, but agents can still perform key tasks like adding, listing, and searching documents effectively.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers