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

Ü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

Öffnen Sie Claude Desktop und stellen Sie eine Verbindung zum Needle MCP-Server her.
Verwenden Sie einfache Textbefehle zum Suchen, Abrufen oder Ändern von Dokumenten.
Ü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

Klonen Sie das Repository:

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

Installieren Sie UV global mit Homebrew im Terminal:

brew install uv

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
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" } } } }

Holen Sie sich Ihren Needle-API-Schlüssel von needle.xyz
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
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:

Finden Sie alle Claude Desktop-Konfigurationsdateien:

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

Entfernen Sie alle Claude Desktop-Daten:

Unter MacOS: rm -rf ~/Library/Application\ Support/Claude/*
Unter 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_mcp": { "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 (Befehl+Q auf dem Mac) und starten Sie es neu
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.