Construir Agentes Con Needle Mcp Server
Integración de Needle en el protocolo modelcontext.
Resumen
¿Qué es Needle-MCP?
Needle-MCP es una integración innovadora del marco Needle dentro del Protocolo de Contexto de Modelo (MCP). Este repositorio sirve como un recurso público para desarrolladores e investigadores interesados en aprovechar las capacidades de Needle en sus proyectos. El marco Needle está diseñado para mejorar el rendimiento del modelo y agilizar el proceso de desarrollo, convirtiéndolo en una herramienta valiosa para aplicaciones de aprendizaje automático e inteligencia artificial.
Características de Needle-MCP
- Integración Sin Problemas: Needle-MCP permite una fácil integración del marco Needle en proyectos existentes, facilitando un flujo de trabajo más fluido para los desarrolladores.
- Rendimiento Mejorado: Al utilizar Needle, los usuarios pueden esperar un rendimiento mejorado del modelo, lo que lleva a predicciones más precisas y mejores resultados en general.
- Repositorio Público: Al ser un repositorio público, Needle-MCP fomenta la colaboración y las contribuciones de la comunidad, promoviendo la innovación y el conocimiento compartido.
- Documentación y Soporte: Se dispone de documentación completa para guiar a los usuarios a través de la instalación y el uso de Needle-MCP, asegurando que los desarrolladores puedan comenzar rápidamente.
Cómo Usar Needle-MCP
- Clona el Repositorio: Comienza clonando el repositorio de Needle-MCP en tu máquina local usando Git.
git clone https://github.com/needle-ai/needle-mcp.git
- Instala Dependencias: Navega al directorio clonado e instala las dependencias necesarias.
cd needle-mcp pip install -r requirements.txt
- Integra con Tu Modelo: Sigue la documentación proporcionada para integrar Needle en el contexto de tu modelo. Esto puede implicar modificar el código de tu modelo para utilizar las características de Needle de manera efectiva.
- Ejecuta Tu Modelo: Después de la integración, ejecuta tu modelo como de costumbre y observa las mejoras en el rendimiento facilitadas por Needle.
Preguntas Frecuentes
¿Cuál es el propósito de Needle-MCP?
Needle-MCP tiene como objetivo proporcionar a los desarrolladores un marco robusto para mejorar el rendimiento del modelo a través de la integración de Needle dentro del Protocolo de Contexto de Modelo.
¿Es Needle-MCP adecuado para todos los tipos de modelos?
Sí, Needle-MCP está diseñado para ser versátil y puede integrarse con varios tipos de modelos de aprendizaje automático, lo que lo hace adecuado para una amplia gama de aplicaciones.
¿Cómo puedo contribuir a Needle-MCP?
¡Las contribuciones son bienvenidas! Puedes contribuir enviando problemas, solicitudes de características o solicitudes de extracción en el repositorio de GitHub. Se fomenta la colaboración para mejorar aún más el marco.
¿Dónde puedo encontrar la documentación para Needle-MCP?
La documentación está disponible dentro del repositorio, típicamente en una carpeta docs
o como un archivo README. Proporciona instrucciones detalladas sobre la instalación, el uso y ejemplos.
¿Qué licencia utiliza Needle-MCP?
Needle-MCP está bajo la Licencia MIT, lo que permite tanto el uso personal como comercial, siempre que se dé la atribución adecuada.
Detalle
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
Configuración del Servidor
{
"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"
}
}
}
}