使用 Needle MCP 服务器构建代理

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

概述

Needle MCP 服务器允许您：

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

特征

**文档管理：**轻松添加和组织服务器上的文档。
**搜索和检索：**基于 Claude 的自然语言搜索，快速获得答案。
**轻松集成：**可与Claude Desktop和 Needle 系列配合使用。

用法

Claude Desktop 中的命令

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

打开 Claude Desktop并连接到 Needle MCP 服务器。
使用简单的文本命令来搜索、检索或修改文档。
在用户友好的界面中查看 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

手动安装

克隆存储库：

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

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

brew install uv

创建claude_desktop_config.json：
- 对于 MacOS：打开目录~/Library/Application Support/Claude/并在其中创建文件
- 对于 Windows：打开目录%APPDATA%/Claude/并在其中创建文件
将此配置添加到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"
      }
    }
  }
}

从needle.xyz获取您的Needle API密钥
更新配置文件：
- 将/path/to/needle-mcp替换为您的实际存储库路径
- 添加您的 Needle API 密钥
彻底退出 Claude 并重新打开它

使用示例

“创建一个名为‘技术文档’的新集合”
“将此文档添加到集合中，即https://needle-ai.com ”
“在收藏中搜索有关人工智能的信息”
“列出我的所有收藏”

故障排除

如果不起作用：

确保 UV 已全局安装（如果没有，请使用pip uninstall uv卸载，然后使用brew install uv重新安装）
或者使用which uv查找 UV 路径，并将"command": "uv"替换为完整路径
验证您的 Needle API 密钥是否正确
检查配置中的needle-mcp路径是否与你的实际仓库位置匹配

重置 Claude 桌面配置

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

查找所有 Claude Desktop 配置文件：

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

删除所有 Claude Desktop 数据：

在 MacOS 上： rm -rf ~/Library/Application\ Support/Claude/*
在 Windows 上：删除%APPDATA%/Claude/的内容

仅使用 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

完全退出 Claude Desktop（Mac 上为 Command+Q）并重新启动
如果您仍然看到旧配置：

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

Needle MCP Server