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
Características
Uso
- Comandos en Claude Desktop
- Resultado en Aguja
Instalación
Explicación en vídeo

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

Instalación mediante herrería

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:

brew install uv

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

Needle MCP Server