Costruisci Agenti Con Needle Mcp Server
Integrazione di Needle nel protocollo modelcontext
Panoramica
Cos'è Needle-MCP?
Needle-MCP è un'integrazione innovativa del framework Needle all'interno del Model Context Protocol (MCP). Questo repository funge da risorsa pubblica per sviluppatori e ricercatori interessati a sfruttare le capacità di Needle nei loro progetti. Il framework Needle è progettato per migliorare le prestazioni del modello e semplificare il processo di sviluppo, rendendolo uno strumento prezioso per applicazioni di machine learning e intelligenza artificiale.
Caratteristiche di Needle-MCP
- Integrazione senza soluzione di continuità: Needle-MCP consente un'integrazione facile del framework Needle nei progetti esistenti, facilitando un flusso di lavoro più fluido per gli sviluppatori.
- Prestazioni migliorate: Utilizzando Needle, gli utenti possono aspettarsi prestazioni migliorate del modello, portando a previsioni più accurate e risultati complessivi migliori.
- Repository pubblico: Essendo un repository pubblico, Needle-MCP incoraggia la collaborazione e i contributi della comunità, promuovendo innovazione e conoscenza condivisa.
- Documentazione e supporto: È disponibile una documentazione completa per guidare gli utenti attraverso l'installazione e l'uso di Needle-MCP, assicurando che gli sviluppatori possano iniziare rapidamente.
Come utilizzare Needle-MCP
- Clona il Repository: Inizia clonando il repository Needle-MCP sulla tua macchina locale utilizzando Git.
git clone https://github.com/needle-ai/needle-mcp.git
- Installa le Dipendenze: Naviga nella directory clonata e installa le dipendenze necessarie.
cd needle-mcp pip install -r requirements.txt
- Integra con il Tuo Modello: Segui la documentazione fornita per integrare Needle nel tuo contesto di modello. Questo potrebbe comportare la modifica del codice del tuo modello per utilizzare efficacemente le funzionalità di Needle.
- Esegui il Tuo Modello: Dopo l'integrazione, esegui il tuo modello come al solito e osserva i miglioramenti delle prestazioni facilitati da Needle.
Domande Frequenti
Qual è lo scopo di Needle-MCP?
Needle-MCP mira a fornire agli sviluppatori un framework robusto per migliorare le prestazioni del modello attraverso l'integrazione di Needle all'interno del Model Context Protocol.
Needle-MCP è adatto a tutti i tipi di modelli?
Sì, Needle-MCP è progettato per essere versatile e può essere integrato con vari tipi di modelli di machine learning, rendendolo adatto a una vasta gamma di applicazioni.
Come posso contribuire a Needle-MCP?
I contributi sono benvenuti! Puoi contribuire segnalando problemi, richieste di funzionalità o pull request sul repository GitHub. La collaborazione è incoraggiata per migliorare ulteriormente il framework.
Dove posso trovare la documentazione per Needle-MCP?
La documentazione è disponibile all'interno del repository stesso, tipicamente in una cartella docs
o come file README. Fornisce istruzioni dettagliate su installazione, utilizzo ed esempi.
Quale licenza utilizza Needle-MCP?
Needle-MCP è concesso in licenza sotto la Licenza MIT, che consente sia l'uso personale che commerciale, a condizione che venga fornita la corretta attribuzione.
Dettaglio
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
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:
- Open Claude Desktop and connect to the Needle MCP Server.
- Use simple text commands to search, retrieve, or modify documents.
- 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
- Clone the repository:
git clone https://github.com/yourusername/needle-mcp.git
- Install UV globally using Homebrew in Terminal:
brew install uv
-
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
- For MacOS: Open directory
-
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"
}
}
}
}
-
Get your Needle API key from needle.xyz
-
Update the config file:
- Replace
/path/to/needle-mcp
with your actual repository path - Add your Needle API key
- Replace
-
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 withbrew 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:
- Find all Claude Desktop config files:
find / -name "claude_desktop_config.json" 2>/dev/null
- Remove all Claude Desktop data:
- On MacOS:
rm -rf ~/Library/Application\ Support/Claude/*
- On Windows: Delete contents of
%APPDATA%/Claude/
- 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
-
Completely quit Claude Desktop (Command+Q on Mac) and relaunch it
-
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
Configurazione Server
{
"mcpServers": {
"needle-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--needle-ai--needle-mcp--needle-mcp",
"needle-mcp"
],
"env": {
"NEEDLE_API_KEY": "needle-api-key"
}
}
}
}