AI导哈

文档管理搜索服务器

Needle MCP Server 是一个基于Model Context Protocol的服务器，用于管理文档并通过Claude的桌面应用程序进行搜索，适用于需要快速检索和组织文档的场景。

  • by needle-ai
  • Python
  • 本地部署
  • 104 星标
  • 更新于
在 GitHub 查看 needle-ai/needle-mcp

使用说明

使用Needle MCP服务器构建代理

MCP（模型上下文协议）服务器，用于管理文档和执行搜索 针 通过Claude的桌面应用程序。

目录

概述

Needle MCP服务器允许您：

  • 组织和存储文档，以便快速检索。
  • 通过Claude的大型语言模型执行强大的搜索。
  • 与Needle生态系统无缝集成，实现高级文档管理。

MCP（模型上下文协议）规范了LLM连接到外部数据源的方式。您可以使用Needle MCP Server在您的AI应用程序中轻松启用语义搜索工具，使埋藏在PDF、DOCX、XLSX和其他文件中的数据可由LLM立即访问。

我们建议使用我们的远程MCP服务器 为了获得最佳体验，无需进行本地设置。

特性

  • 文件管理： 在服务器上轻松添加和组织文档。
  • 搜索和检索： 基于克劳德的自然语言搜索快速答案。
  • 易于集成： 使用 克劳德桌面 以及针系列。

用法

Claude Desktop中的命令

以下是在Claude Desktop中如何使用命令与服务器交互的示例：

  1. 打开克劳德桌面 并连接到Needle MCP服务器。
  2. 使用简单的文本命令 搜索、检索或修改文档。
  3. 查看搜索结果 Claude以用户友好的界面返回。

针的结果

https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c

Youtube视频解说

有关在Claude和Claude Desktop中使用Needle MCP服务器的完整演练，请观看以下内容 YouTube解说视频.

安装

1.远程MCP服务器（推荐）

Claude桌面配置

创建或更新您的配置文件：

  • 对于MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 对于Windows： %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:Bearer ${NEEDLE_API_KEY}"
      ],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

游标配置

创建或更新 .cursor/mcp.json:

{
  "mcpServers": {
    "needle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.needle.app/mcp",
        "--header",
        "Authorization:${NEEDLE_AUTH_HEADER}"
      ],
      "env": {
        "NEEDLE_AUTH_HEADER": "Bearer <your-needle-api-key>"
      }
    }
  }
}

从获取API密钥 针设置.

我们提供两个端点：

  • 流式HTTP: https://mcp.needle.app/mcp （推荐）
  • 上海证券交易所: https://mcp.needle.app/sse

注意：MCP在最新规范中弃用了SSE端点，因此较新的客户端应该更喜欢Streamable HTTP端点。

2.本地安装

  1. 克隆存储库：
git clone https://github.com/needle-ai/needle-mcp.git
  1. 使用Homebrew全局安装UV：
brew install uv
  1. 创建配置文件：
    • 对于MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 对于Windows： %APPDATA%/Claude/claude_desktop_config.json

Claude桌面配置

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}

游标配置

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}
  1. 替换 /path/to/needle-mcp 使用您的实际存储库路径
  2. 添加您的Needle API密钥
  3. 重新启动克劳德桌面

通过Smithery安装

npx -y @smithery/cli install needle-mcp --client claude

3.Docker安装

  1. 克隆和构建：
git clone https://github.com/needle-ai/needle-mcp.git
cd needle-mcp
docker build -t needle-mcp .
  1. 添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "needle": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "needle-mcp"],
      "env": {
        "NEEDLE_API_KEY": "<your-needle-api-key>"
      }
    }
  }
}
  1. 重新启动克劳德桌面

使用示例

  • “创建一个名为“技术文档”的新集合”
  • “将此文档添加到集合中，即https://needle.app"
  • “在集合中搜索有关AI的信息”
  • “列出我的所有收藏”

故障排除

如果不工作：

  • 确保 uv 全局安装（如果不是，请使用卸载 pip uninstall uv 并重新安装 brew install uv)
  • 或查找 uv 路径与 which uv 并替换 "command": "uv" 完整的路径
  • 验证您的针头API钥匙是否正确
  • 检查配置中的针mcp路径是否与您的实际存储库位置匹配

重置Claude桌面配置

如果您看到旧配置或集成不起作用：

  1. 查找所有Claude Desktop配置文件：
find / -name "claude_desktop_config.json" 2>/dev/null
  1. 删除所有Claude Desktop数据：
  • 在MacOS上： rm -rf ~/Library/Application\ Support/Claude/*
  • 在Windows上：删除以下内容 %APPDATA%/Claude/
  1. 仅使用Needle创建新配置：
mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
<< 'EOL'
{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL

  1. 完全退出Claude Desktop（Mac上的Command+Q）并重新启动它

  2. 如果您仍然看到旧配置：

  • 检查其他位置的其他配置文件
  • 如果使用web版本，请尝试清除浏览器缓存
  • 验证配置文件是否从正确位置读取

相关 MCP