drio
Open app

Needle MCP Server

Source

Integration of Needle in modelcontextprotocol

Catalog onlyCatalog onlySTDIO

Overview

Needle MCP Server is an implementation of a Model Context Protocol (MCP) server that integrates AI capabilities, specifically with Claude, to manage and search through document collections utilizing AI-powered Retrieval Augmented Generation (RAG).

To use the Needle MCP Server, users can integrate the server with their document collections, allowing natural language queries to manage and retrieve documents effectively. Detailed installation instructions can be found in the project's GitHub repository.

  • Document Collection Management: Users can create and manage collections of documents. - File Integration: Add files to collections easily via URLs. - Smart Search: Execute semantic search to find relevant documents across collections. - RAG Support: Supports advanced Retrieval Augmented Generation functionalities. - Intuitive Error Handling: Provides clear feedback to improve user experience.
  1. Managing and searching large document repositories in legal or academic settings.
  2. Enhancing research workflows by quickly retrieving relevant information from vast collections.
  3. Assisting content creators with document management and retrieval for writing and editing projects.

Add to your AI client

Use these steps to connect Needle MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "needle-mcp-server-janhms": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-needle-mcp-server-janhms"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "needle-mcp-server-janhms": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-needle-mcp-server-janhms"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "needle-mcp-server-janhms": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-needle-mcp-server-janhms"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "needle-mcp-server-janhms": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-needle-mcp-server-janhms"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "needle-mcp-server-janhms": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-needle-mcp-server-janhms"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "needle-mcp-server-janhms": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-needle-mcp-server-janhms"
      ]
    }
  }
}

FAQ

What is the main function of Needle MCP Server?

It allows users to manage and search document collections using natural language queries with AI integration.

Can I add any file type to the document collections?

Yes, users can add files through URLs, provided that the files are supported in the system.

Is there documentation available for setup?

Yes, detailed installation and usage documentation can be found on the [GitHub repository](https://github.com/JANHMS/needle-mcp-server).7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":433,"uuid":"9fbc3c5d-63b7-4a61-81df-9429517a7a95","name":"needle-mcp-server","title":"Needle MCP Server","description":"Integration of Needle in modelcontextprotocol","avatar_url":"https://avatars.githubusercontent.com/u/45521680?v=4","created_at":"2024-12-16T07:24:07.744Z","updated_at":"2024-12-19T12:38:44.853Z","status":"created","author_name":"JANHMS","author_avatar_url":"https://avatars.githubusercontent.com/u/45521680?v=4","tags":"needle-mcp-server,AI-integration,document-management","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/JANHMS/needle-mcp-server","target":"_self","content":"# Needle MCP Server\n\nAn MCP (Model Context Protocol) server implementation that integrates Claude with Needle, enabling AI-powered RAG (Retrieval Augmented Generation) capabilities. This server allows Claude to manage and search through document collections using natural language.\n\n## Features\n\n* **Document Collection Management**: Create and manage collections of documents\n* **File Integration**: Add files to collections via URLs\n* **Smart Search**: Perform semantic search across collections\n* **RAG Support**: Built-in support for Retrieval Augmented Generation\n* **Intuitive Error Handling**: Clear feedback for better user experience\n\n## Installation","summary":"$29","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data