Needle MCP server

Name: Needle MCP server
Author: MCP-Mirror

@MCP-Mirror

代码仓库

关于 Needle MCP server

Mirror of

#needle #mcp-server #semantic-search

基本信息

分类

其他

传输方式

stdio

发布者

MCP-Mirror

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": ""
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Needle MCP server?

Needle MCP server is an MCP server that enables managing documents and performing semantic search through Claude chat using the Needle platform. It allows users to create collections, add documents, search across collections, and list collections directly from Claude.

How to use Needle MCP server?

Clone the repository and install UV globally via Homebrew (brew install uv). 2. Create or edit claude_desktop_config.json in the Claude config directory, adding a needle_mcp entry with the uv command, the repository path, and your Needle API key. 3. Restart Claude Desktop. Then use natural language commands like “Create a new collection called 'Technical Docs'” or “Search the collection for information about AI.”

Key features of Needle MCP server

Create new collections in Needle from Claude
Add documents (URLs) to collections
Perform semantic search across collections
List all existing collections
Integrates Needle’s document management into Claude chat

Use cases of Needle MCP server

Organize technical documentation into searchable collections via chat
Add web articles to a Needle collection without leaving Claude
Quickly find relevant information across multiple documents by asking Claude
List and manage all your Needle collections conversationally

FAQ from Needle MCP server

Where do I put the configuration file?

For MacOS, create claude_desktop_config.json inside ~/Library/Application Support/Claude/. For Windows, use %APPDATA%/Claude/.

How do I get my Needle API key?

Get your Needle API key from needle.xyz.

What runtime does Needle MCP server require?

It requires UV installed globally. Install it with brew install uv on macOS. If UV is not found, you can find its full path with which uv and replace the command in the config.

How do I reset the configuration if it’s not working?

Remove all Claude Desktop data (on Mac: rm -rf ~/Library/Application\ Support/Claude/*), then create a fresh config file with only the Needle MCP entry and restart Claude.