Needle

Needle

Production-ready RAG out of the box to search and retrieve data from your own documents.

85
Stars
22
Forks
0
Releases

Overview

Needle MCP Server is a Model Context Protocol (MCP) server that lets you organize, store, and rapidly retrieve documents, while enabling semantic search over your data using Claude's large language model. It integrates with the Needle ecosystem and Claude Desktop to facilitate search-driven workflows and management of documents across PDFs, DOCX, XLSX, and other file types. The README positions remote MCP as the recommended deployment for best experience, exposing endpoints: Streamable HTTP at https://mcp.needle.app/mcp and SSE at https://mcp.needle.app/sse (SSE deprecated in the latest spec). You can connect Claude Desktop to the server via configuration blocks that specify the mcpServers needle entry with a command (npx mcp-remote) and an API key. The project also describes a local installation path using uv, a Docker-based setup, and optional installation through Smithery. It includes concrete config examples for Claude Desktop and Cursor, instructions to obtain a Needle API key, and guidance on restarting Claude Desktop. Troubleshooting and reset steps for Claude Desktop configurations are provided. This is a production-ready solution for searching and retrieving data from your own documents using Needle and Claude.

Details

Owner
needle-ai
Language
Python
License
MIT License
Updated
2025-12-07

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.