使用 Needle MCP 服务器构建代理

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

目录

• 概述

• 特征

• 用法

  • Claude Desktop 中的命令

  • 导致针

• 安装

• 视频讲解

Related MCP server: MCP Web Research Server

概述

Needle MCP 服务器允许您：

• 组织和存储文档以便快速检索。

• 通过 Claude 的大型语言模型执行强大的搜索。

• 与 Needle 生态系统无缝集成，实现高级文档管理。

特征

• **文档管理：**轻松添加和组织服务器上的文档。

• **搜索和检索：**基于 Claude 的自然语言搜索，快速获得答案。

• **轻松集成：**可与Claude Desktop和 Needle 系列配合使用。

用法

Claude Desktop 中的命令

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

1. 打开 Claude Desktop并连接到 Needle MCP 服务器。

2. 使用简单的文本命令来搜索、检索或修改文档。

3. 在用户友好的界面中查看 Claude 返回的搜索结果。

导致针

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

Youtube视频讲解

有关使用 Needle MCP Server 与 Claude 和 Claude Desktop 的完整演练，请观看此YouTube 解释视频。

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Needle MCP：

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

手动安装

1. 克隆存储库：

git clone https://github.com/yourusername/needle-mcp.git

2. 在终端中使用 Homebrew 全局安装 UV：

brew install uv

3. 创建claude_desktop_config.json：

   • 对于 MacOS：打开目录~/Library/Application Support/Claude/并在其中创建文件

   • 对于 Windows：打开目录%APPDATA%/Claude/并在其中创建文件

4. 将此配置添加到claude_desktop_config.json：

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

5. 从needle.xyz获取您的Needle API密钥

6. 更新配置文件：

   • 将/path/to/needle-mcp替换为您的实际存储库路径

   • 添加您的 Needle API 密钥

7. 彻底退出 Claude 并重新打开它

使用示例

• “创建一个名为‘技术文档’的新集合”

• “将此文档添加到集合中，即https://needle-ai.com ”

• “在收藏中搜索有关人工智能的信息”

• “列出我的所有收藏”

故障排除

如果不起作用：

• 确保 UV 已全局安装（如果没有，请使用pip uninstall uv卸载，然后使用brew install uv重新安装）

• 或者使用which uv查找 UV 路径，并将"command": "uv"替换为完整路径

• 验证您的 Needle API 密钥是否正确

• 检查配置中的needle-mcp路径是否与你的实际仓库位置匹配

重置 Claude 桌面配置

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

1. 查找所有 Claude Desktop 配置文件：

find / -name "claude_desktop_config.json" 2>/dev/null

2. 删除所有 Claude Desktop 数据：

• 在 MacOS 上： rm -rf ~/Library/Application\ Support/Claude/*

• 在 Windows 上：删除%APPDATA%/Claude/的内容

3. 仅使用 Needle 创建一个新配置：

mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json
<< 'EOL'
{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
EOL

4. 完全退出 Claude Desktop（Mac 上为 Command+Q）并重新启动

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

• 检查其他位置的附加配置文件

• 如果使用网页版，请尝试清除浏览器缓存

• 验证配置文件是否从正确的位置读取