Needle MCP

使用Needle MCP服务器构建代理

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

目录

• 概述
• 特性
• 用法

- Claude Desktop中的命令 - 针的结果

• 安装
• 视频解说

______________________________________________________________________

概述

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": ""
      }
    }
  }
}

游标配置

创建或更新 .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 "
      }
    }
  }
}

从获取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": ""
      }
    }
  }
}

游标配置

{
  "mcpServers": {
    "needle": {
      "command": "uv",
      "args": ["--directory", "/path/to/needle-mcp", "run", "needle-mcp"],
      "env": {
        "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": ""
      }
    }
  }
}

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）并重新启动它

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

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