Needle MCP Server

offiziell

Produktionsreifes RAG direkt einsatzbereit, um Daten aus Ihren eigenen Dokumenten zu durchsuchen und abzurufen.

Dokumentation

Build Agents mit Needle MCP Server

Screenshot of Feature - Claude

MCP (Model Context Protocol) Server zur Verwaltung von Dokumenten und Durchführung von Suchen mit Needle über die Claude Desktop-Anwendung.

Inhaltsverzeichnis

Übersicht
Funktionen
Verwendung
- Befehle in Claude Desktop
- Ergebnis in Needle
Installation
Video-Erklärung

Übersicht

Der Needle MCP Server ermöglicht Ihnen:

Dokumente zu organisieren und für schnellen Abruf zu speichern.
Leistungsstarke Suchen über das große Sprachmodell von Claude durchzuführen.
Nahtlose Integration in das Needle-Ökosystem für erweitertes Dokumentenmanagement.

MCP (Model Context Protocol) standardisiert die Art und Weise, wie LLMs mit externen Datenquellen verbunden werden. Sie können den Needle MCP Server nutzen, um semantische Suchwerkzeuge einfach in Ihre KI-Anwendungen zu integrieren und Daten, die in PDFs, DOCX, XLSX und anderen Dateien vergraben sind, sofort für LLMs zugänglich zu machen.

Wir empfehlen die Verwendung unseres Remote-MCP-Servers für das beste Erlebnis – keine lokale Einrichtung erforderlich.

Funktionen

Dokumentenmanagement: Einfaches Hinzufügen und Organisieren von Dokumenten auf dem Server.
Suche & Abruf: Claude-basierte Suche in natürlicher Sprache für schnelle Antworten.
Einfache Integration: Funktioniert mit Claude Desktop und Needle-Sammlungen.

Verwendung

Befehle in Claude Desktop

Nachfolgend ein Beispiel, wie die Befehle in Claude Desktop verwendet werden können, um mit dem Server zu interagieren:

Using commands in Claude Desktop

Öffnen Sie Claude Desktop und verbinden Sie sich mit dem Needle MCP Server.
Verwenden Sie einfache Textbefehle, um zu suchen, abzurufen oder Dokumente zu ändern.
Überprüfen Sie die Suchergebnisse, die von Claude in einer benutzerfreundlichen Oberfläche zurückgegeben werden.

Ergebnis in Needle

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

Youtube-Video-Erklärung

Für eine vollständige Anleitung zur Verwendung des Needle MCP Servers mit Claude und Claude Desktop sehen Sie sich dieses YouTube-Erklärvideo an.

Installation

1. Remote MCP Server (Empfohlen)

Claude Desktop Konfiguration

Erstellen oder aktualisieren Sie Ihre Konfigurationsdatei:

Für MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Für Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:Bearer ${NEEDLE_API_KEY}"
      ],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Cursor Konfiguration

Erstellen oder aktualisieren Sie .cursor/mcp.json:

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:${NEEDLE_AUTH_HEADER}"
      ],
      "env": {
        "NEEDLE_AUTH_HEADER": "Bearer <your-needle-api-key>"
      }
    }
  }
}

Holen Sie sich Ihren API-Schlüssel in den Needle-Einstellungen.

Wir bieten zwei Endpunkte an:

Streamable HTTP: https://mcp.needle.app/mcp (empfohlen)
SSE: https://mcp.needle.app/sse

Hinweis: MCP hat SSE-Endpunkte in der neuesten Spezifikation als veraltet markiert, daher sollten neuere Clients den Streamable-HTTP-Endpunkt bevorzugen.

2. Lokale Installation

Repository klonen:

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

UV global mit Homebrew installieren:

brew install uv

Konfigurationsdatei erstellen:
- Für MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Für Windows: %APPDATA%/Claude/claude_desktop_config.json

Claude Desktop Konfiguration

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Cursor Konfiguration

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Ersetzen Sie /path/to/needle-mcp durch Ihren tatsächlichen Repository-Pfad
Fügen Sie Ihren Needle-API-Schlüssel hinzu
Starten Sie Claude Desktop neu

Installation über Smithery

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

3. Docker-Installation

Klonen und bauen:

git clone https://github.com/needle-ai/needle-mcp.git
cd needle-mcp
docker build -t needle-mcp .

Zur Claude Desktop Konfiguration hinzufügen (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "needle": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

Claude Desktop neu starten

Anwendungsbeispiele

"Erstelle eine neue Sammlung namens 'Technische Dokumente'"
"Füge dieses Dokument zur Sammlung hinzu, das ist https://needle.app"
"Durchsuche die Sammlung nach Informationen über KI"
"Liste alle meine Sammlungen auf"

Fehlerbehebung

Wenn es nicht funktioniert:

Stellen Sie sicher, dass uv global installiert ist (falls nicht, deinstallieren Sie es mit pip uninstall uv und installieren Sie es erneut mit brew install uv)
Oder finden Sie den Pfad von uv mit which uv und ersetzen Sie "command": "uv" durch den vollständigen Pfad
Überprüfen Sie, ob Ihr Needle-API-Schlüssel korrekt ist
Prü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:

Finden Sie alle Claude Desktop Konfigurationsdateien:

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

Entfernen Sie alle Claude Desktop Daten:

Auf MacOS: rm -rf ~/Library/Application\ Support/Claude/*
Auf Windows: Löschen Sie den Inhalt von %APPDATA%/Claude/

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": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL

Beenden Sie Claude Desktop vollständig (Command+Q auf dem Mac) und starten Sie es neu
Wenn Sie immer noch alte Konfigurationen sehen:

Überprüfen Sie, ob es zusätzliche Konfigurationsdateien an anderen Orten gibt
Versuchen Sie, den Browser-Cache zu leeren, wenn Sie die Webversion verwenden
Stellen Sie sicher, dass die Konfigurationsdatei vom richtigen Ort gelesen wird