Crear agentes con Needle MCP Server
Servidor MCP (Model Context Protocol) para gestionar documentos y realizar búsquedas utilizando Needle a través de la aplicación de escritorio de Claude.
Tabla de contenido
Descripción general
El servidor Needle MCP le permite:
- Organice y almacene documentos para una rápida recuperación.
- Realice búsquedas potentes a través del gran modelo de lenguaje de Claude.
- Se integra perfectamente con el ecosistema Needle para una gestión avanzada de documentos.
Características
- Gestión de documentos: agregue y organice documentos fácilmente en el servidor.
- Búsqueda y recuperación: búsqueda en lenguaje natural basada en Claude para obtener respuestas rápidas.
- Fácil integración: funciona con las colecciones Claude Desktop y Needle.
Uso
Comandos en Claude Desktop
A continuación se muestra un ejemplo de cómo se pueden utilizar los comandos en Claude Desktop para interactuar con el servidor:
- Abra Claude Desktop y conéctese al servidor Needle MCP.
- Utilice comandos de texto simples para buscar, recuperar o modificar documentos.
- Revise los resultados de búsqueda devueltos por Claude en una interfaz fácil de usar.
Resultado en Aguja
https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c
Explicación del vídeo de YouTube
Para obtener una guía completa sobre el uso del servidor Needle MCP con Claude y Claude Desktop, mire este video explicativo de YouTube .
Instalación
Para instalar Needle MCP para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install needle-mcp --client claude
Instalación manual
- Clonar el repositorio:
git clone https://github.com/yourusername/needle-mcp.git
- Instalar UV globalmente usando Homebrew en la Terminal:
- Crear claude_desktop_config.json:
- Para MacOS: Abra el directorio
~/Library/Application Support/Claude/ y cree el archivo dentro de él - Para Windows: Abra el directorio
%APPDATA%/Claude/ y cree el archivo dentro de él
- Agregue esta configuración a 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"
}
}
}
}
- Obtén tu clave API de Needle en needle.xyz
- Actualice el archivo de configuración:
- Reemplace
/path/to/needle-mcp con su ruta de repositorio real - Añade tu clave API de Needle
- Salga de Claude por completo y vuelva a abrirlo.
Ejemplos de uso
- "Crear una nueva colección llamada 'Documentos técnicos'"
- Añade este documento a la colección, que es https://needle-ai.com
- "Buscar información sobre IA en la colección"
- "Enumerar todas mis colecciones"
Solución de problemas
Si no funciona:
- Asegúrese de que UV esté instalado globalmente (si no, desinstálelo con
pip uninstall uv y vuelva a instalarlo con brew install uv ) - O busque la ruta UV con
which uv y reemplace "command": "uv" con la ruta completa - Verifique que su clave API de Needle sea correcta
- Comprueba si la ruta needle-mcp en la configuración coincide con la ubicación real de tu repositorio
Restablecer la configuración del escritorio de Claude
Si ves configuraciones antiguas o la integración no funciona:
- Encuentra todos los archivos de configuración de Claude Desktop:
find / -name "claude_desktop_config.json" 2>/dev/null
- Eliminar todos los datos de Claude Desktop:
- En MacOS:
rm -rf ~/Library/Application\ Support/Claude/* - En Windows: eliminar el contenido de
%APPDATA%/Claude/
- Crea una nueva configuración solo con 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
- Cierre completamente Claude Desktop (Comando+Q en Mac) y reinícielo
- Si aún ves configuraciones antiguas:
- Busque archivos de configuración adicionales en otras ubicaciones
- Intente borrar el caché del navegador si usa la versión web
- Verifique que el archivo de configuración se esté leyendo desde la ubicación correcta