使用 Needle MCP 服务器构建代理

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

目录

• 概述
• 功能
• 用法
  • Claudie Desktop 中的命令
  • Needle 中的结果
• 安装
• 视频说明

---

概述

Needle MCP 服务器允许您：

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

---

功能

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

---

用法

Claudie Desktop 中的命令

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

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

Needle 中的结果

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

---

Youtube 视频说明

有关使用 Needle MCP 服务器与 Claude 和 Claudie Desktop 的完整演练，请观看此 YouTube 说明视频。

---

安装

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 并重新打开它

使用示例

• "创建一个名为 'Technical Docs' 的新集合"
• "将此文档添加到集合，网址为 https://needle-ai.com"
• "在集合中搜索有关 AI 的信息"
• "列出我的所有集合"

故障排除

如果无法正常工作：

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

重置 Claude Desktop 配置

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

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. 如果您仍然看到旧的配置：

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