Needle MCP Server

officiel

RAG prêt pour la production, prêt à l'emploi pour rechercher et récupérer des données à partir de vos propres documents.

GitHub
99

Documentation

Construire des agents avec le serveur MCP Needle

smithery badge

Screenshot of Feature - Claude

Serveur MCP (Model Context Protocol) pour gérer des documents et effectuer des recherches en utilisant Needle via l'application de bureau Claude.

Needle Server MCP server

Table des matières

Aperçu

Le serveur MCP Needle vous permet de :

  • Organiser et stocker des documents pour une récupération rapide.
  • Effectuer des recherches puissantes via le grand modèle de langage de Claude.
  • S'intégrer de manière transparente à l'écosystème Needle pour une gestion avancée des documents.

MCP (Model Context Protocol) standardise la manière dont les LLM se connectent aux sources de données externes. Vous pouvez utiliser le serveur MCP Needle pour activer facilement des outils de recherche sémantique dans vos applications d'IA, rendant les données enfouies dans des PDF, DOCX, XLSX et autres fichiers instantanément accessibles par les LLM.

Nous recommandons d'utiliser notre serveur MCP distant pour une expérience optimale - aucune configuration locale requise.

Fonctionnalités

  • Gestion de documents : Ajoutez et organisez facilement des documents sur le serveur.
  • Recherche et récupération : Recherche en langage naturel basée sur Claude pour des réponses rapides.
  • Intégration facile : Fonctionne avec Claude Desktop et les collections Needle.

Utilisation

Commandes dans Claude Desktop

Voici un exemple de la manière dont les commandes peuvent être utilisées dans Claude Desktop pour interagir avec le serveur :

Using commands in Claude Desktop

  1. Ouvrez Claude Desktop et connectez-vous au serveur MCP Needle.
  2. Utilisez des commandes textuelles simples pour rechercher, récupérer ou modifier des documents.
  3. Consultez les résultats de recherche renvoyés par Claude dans une interface conviviale.

Résultat dans Needle

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

Explication vidéo Youtube

Pour une présentation complète de l'utilisation du serveur MCP Needle avec Claude et Claude Desktop, regardez cette vidéo d'explication YouTube.

Installation

1. Serveur MCP distant (recommandé)

Configuration de Claude Desktop

Créez ou mettez à jour votre fichier de configuration :

  • Pour MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Pour 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>"
      }
    }
  }
}

Configuration de Cursor

Créez ou mettez à jour .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>"
      }
    }
  }
}

Obtenez votre clé API depuis les paramètres Needle.

Nous fournissons deux points de terminaison :

  • HTTP streamable : https://mcp.needle.app/mcp (recommandé)
  • SSE : https://mcp.needle.app/sse

Remarque : MCP a déprécié les points de terminaison SSE dans la dernière spécification, les clients plus récents devraient donc préférer le point de terminaison HTTP streamable.

2. Installation locale

  1. Clonez le dépôt :
git clone https://github.com/needle-ai/needle-mcp.git
  1. Installez UV globalement en utilisant Homebrew :
brew install uv
  1. Créez votre fichier de configuration :
    • Pour MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
    • Pour Windows : %APPDATA%/Claude/claude_desktop_config.json

Configuration de Claude Desktop

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

Configuration de Cursor

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}
  1. Remplacez /path/to/needle-mcp par le chemin réel de votre dépôt
  2. Ajoutez votre clé API Needle
  3. Redémarrez Claude Desktop

Installation via Smithery

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

3. Installation Docker

  1. Clonez et construisez :
git clone https://github.com/needle-ai/needle-mcp.git
cd needle-mcp
docker build -t needle-mcp .
  1. Ajoutez à votre configuration Claude Desktop (~/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>"
      }
    }
  }
}
  1. Redémarrez Claude Desktop

Exemples d'utilisation

  • "Créez une nouvelle collection appelée 'Documents techniques'"
  • "Ajoutez ce document à la collection, qui est https://needle.app"
  • "Recherchez dans la collection des informations sur l'IA"
  • "Listez toutes mes collections"

Dépannage

Si cela ne fonctionne pas :

  • Assurez-vous que uv est installé globalement (sinon, désinstallez avec pip uninstall uv et réinstallez avec brew install uv)
  • Ou trouvez le chemin de uv avec which uv et remplacez "command": "uv" par le chemin complet
  • Vérifiez que votre clé API Needle est correcte
  • Vérifiez si le chemin needle-mcp dans la configuration correspond à l'emplacement réel de votre dépôt

Réinitialiser la configuration de Claude Desktop

Si vous voyez d'anciennes configurations ou si l'intégration ne fonctionne pas :

  1. Trouvez tous les fichiers de configuration de Claude Desktop :
find / -name "claude_desktop_config.json" 2>/dev/null
  1. Supprimez toutes les données de Claude Desktop :
  • Sur MacOS : rm -rf ~/Library/Application\ Support/Claude/*
  • Sur Windows : Supprimez le contenu de %APPDATA%/Claude/
  1. Créez une nouvelle configuration avec seulement 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

  1. Quittez complètement Claude Desktop (Commande+Q sur Mac) et relancez-le

  2. Si vous voyez encore d'anciennes configurations :

  • Vérifiez les fichiers de configuration supplémentaires à d'autres emplacements
  • Essayez de vider le cache du navigateur si vous utilisez la version web
  • Vérifiez que le fichier de configuration est lu depuis le bon emplacement