Needle MCP 服务器

一个 MCP 服务器，用于管理文档并通过使用 Needle 的 Claude 聊天进行语义搜索。

示例

我们如何在 Claudie Desktop 中使用命令

<img width="592" alt="Screenshot 2024-12-17 at 12 25 03 PM" src="https://github.com/user-attachments/assets/9e0ce522-6675-46d9-9bfb-3162d214625b" />

你通过 Claude 在 Needle 中设置此集合

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

快速设置

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 版本，请尝试清除浏览器缓存
• 验证是否从正确的位置读取配置文件