Construire des agents avec le serveur Needle Mcp

Qu'est-ce que Needle-MCP ?

Needle-MCP est une intégration innovante du framework Needle au sein du Protocole de Contexte de Modèle (MCP). Ce dépôt sert de ressource publique pour les développeurs et les chercheurs intéressés par l'exploitation des capacités de Needle dans leurs projets. Le framework Needle est conçu pour améliorer les performances des modèles et rationaliser le processus de développement, en faisant un outil précieux pour les applications d'apprentissage automatique et d'IA.

Caractéristiques de Needle-MCP

• Intégration Transparente : Needle-MCP permet une intégration facile du framework Needle dans des projets existants, facilitant un flux de travail plus fluide pour les développeurs.
• Performance Améliorée : En utilisant Needle, les utilisateurs peuvent s'attendre à une amélioration des performances des modèles, conduisant à des prédictions plus précises et de meilleurs résultats globaux.
• Dépôt Public : En tant que dépôt public, Needle-MCP encourage la collaboration et les contributions de la communauté, favorisant l'innovation et le partage des connaissances.
• Documentation et Support : Une documentation complète est disponible pour guider les utilisateurs à travers l'installation et l'utilisation de Needle-MCP, garantissant que les développeurs peuvent rapidement commencer.

Comment Utiliser Needle-MCP

1. Cloner le Dépôt : Commencez par cloner le dépôt Needle-MCP sur votre machine locale en utilisant Git.

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

2. Installer les Dépendances : Naviguez vers le répertoire cloné et installez les dépendances nécessaires.

   cd needle-mcp
   pip install -r requirements.txt
   

3. Intégrer avec Votre Modèle : Suivez la documentation fournie pour intégrer Needle dans le contexte de votre modèle. Cela peut impliquer de modifier votre code de modèle pour utiliser efficacement les fonctionnalités de Needle.
4. Exécuter Votre Modèle : Après l'intégration, exécutez votre modèle comme d'habitude et observez les améliorations de performance facilitées par Needle.

Questions Fréquemment Posées

Quel est le but de Needle-MCP ?

Needle-MCP vise à fournir aux développeurs un cadre robuste pour améliorer les performances des modèles grâce à l'intégration de Needle au sein du Protocole de Contexte de Modèle.

Needle-MCP est-il adapté à tous les types de modèles ?

Oui, Needle-MCP est conçu pour être polyvalent et peut être intégré à divers types de modèles d'apprentissage automatique, le rendant adapté à un large éventail d'applications.

Comment puis-je contribuer à Needle-MCP ?

Les contributions sont les bienvenues ! Vous pouvez contribuer en soumettant des problèmes, des demandes de fonctionnalités ou des demandes de tirage sur le dépôt GitHub. La collaboration est encouragée pour améliorer davantage le cadre.

Où puis-je trouver la documentation pour Needle-MCP ?

La documentation est disponible dans le dépôt lui-même, généralement dans un dossier docs ou sous forme de fichier README. Elle fournit des instructions détaillées sur l'installation, l'utilisation et des exemples.

Quelle licence utilise Needle-MCP ?

Needle-MCP est sous licence MIT, permettant une utilisation personnelle et commerciale, à condition que l'attribution appropriée soit donnée.

Build Agents with Needle MCP Server

MCP (Model Context Protocol) server to manage documents and perform searches using Needle through Claude’s Desktop Application.

<a href="https://glama.ai/mcp/servers/5jw1t7hur2"> <img width="380" height="200" src="https://glama.ai/mcp/servers/5jw1t7hur2/badge" alt="Needle Server MCP server" /> </a>

Table of Contents

• Overview
• Features
• Usage
  • Commands in Claude Desktop
  • Result in Needle
• Installation
• Video Explanation

Overview

Needle MCP Server allows you to:

• Organize and store documents for quick retrieval.
• Perform powerful searches via Claude’s large language model.
• Integrate seamlessly with the Needle ecosystem for advanced document management.

Features

• Document Management: Easily add and organize documents on the server.
• Search & Retrieval: Claude-based natural language search for quick answers.
• Easy Integration: Works with Claude Desktop and Needle collections.

Usage

Commands in Claude Desktop

Below is an example of how the commands can be used in Claude Desktop to interact with the server:

1. Open Claude Desktop and connect to the Needle MCP Server.
2. Use simple text commands to search, retrieve, or modify documents.
3. Review search results returned by Claude in a user-friendly interface.

Result in Needle

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

Youtube Video Explanation

For a full walkthrough on using the Needle MCP Server with Claude and Claude Desktop, watch this YouTube explanation video.

Installation

Installing via Smithery

To install Needle MCP for Claude Desktop automatically via Smithery:

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

Manual Installation

1. Clone the repository:

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

2. Install UV globally using Homebrew in Terminal:

brew install uv

3. Create claude_desktop_config.json:

   • For MacOS: Open directory ~/Library/Application Support/Claude/ and create the file inside it
   • For Windows: Open directory %APPDATA%/Claude/ and create the file inside it

4. Add this configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}

5. Get your Needle API key from needle.xyz

6. Update the config file:

   • Replace /path/to/needle-mcp with your actual repository path
   • Add your Needle API key

7. Quit Claude completely and reopen it

Usage Examples

• "Create a new collection called 'Technical Docs'"
• "Add this document to the collection, which is https://needle-ai.com"
• "Search the collection for information about AI"
• "List all my collections"

Troubleshooting

If not working:

• Make sure UV is installed globally (if not, uninstall with pip uninstall uv and reinstall with brew install uv)
• Or find UV path with which uv and replace "command": "uv" with the full path
• Verify your Needle API key is correct
• Check if the needle-mcp path in config matches your actual repository location

Reset Claude Desktop Configuration

If you're seeing old configurations or the integration isn't working:

1. Find all Claude Desktop config files:

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

2. Remove all Claude Desktop data:

• On MacOS: rm -rf ~/Library/Application\ Support/Claude/*
• On Windows: Delete contents of %APPDATA%/Claude/

3. Create a fresh config with only 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

4. Completely quit Claude Desktop (Command+Q on Mac) and relaunch it

5. If you still see old configurations:

• Check for additional config files in other locations
• Try clearing browser cache if using web version
• Verify the config file is being read from the correct location