Needle MCP 快速开始指南

概述

Needle MCP 是一个允许你通过 Claude 使用 Needle 进行语义搜索和集合管理的服务器。

安装步骤

1. 克隆仓库

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

2. 安装 UV

   brew install uv
   

3. 创建配置文件

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

4. 添加配置

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

5. 获取 Needle API 密钥：从 needle.xyz 获取

6. 更新配置：

   • 替换 /path/to/needle-mcp 为实际路径
   • 添加你的 Needle API 密钥

7. 重启 Claude

使用示例

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

故障排除

如果集成不工作：

• 确认 UV 已全局安装
• 验证 API 密钥和路径配置
• 彻底退出并重启 Claude

重置配置

如果需要重置：

1. 查找所有配置文件：

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

2. 删除 Claude 数据：

   • MacOS: rm -rf ~/Library/Application Support/Claude/*
   • Windows: 删除 %APPDATA%/Claude/ 内容

3. 创建新配置并重启 Claude

更多设置示例：