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

Erstellen Sie Agenten mit dem Needle MCP Server

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:

  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.

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

Ein Server, der es Benutzern ermöglicht, Dokumente zu verwalten und mit Needle über die Claude Desktop-Anwendung Claude-gestützte Suchvorgänge durchzuführen.

  1. Inhaltsverzeichnis
    1. Überblick
      1. Merkmale
        1. Verwendung
          1. Befehle in Claude Desktop
          2. Ergebnis in Nadel
        2. Youtube-Video-Erklärung
          1. Installation
            1. Installation über Smithery
            2. Manuelle Installation
          2. Anwendungsbeispiele
            1. Fehlerbehebung
              1. Claude Desktop-Konfiguration zurücksetzen

            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