针对Claude的Needle MCP服务器

一个管理文档并通过Claude聊天进行语义搜索的MCP（管理控制平面）服务器。

示例

我们在Claudie Desktop中使用的命令示例

你通过Claude在Needle上设置此集合的方式

链接到资源

快速设置指南

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获取你的API密钥

6. 更新配置文件：

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

7. 完全退出Claude再重新打开它

使用示例

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

故障排除

如果未正常工作：

• 确保全局安装了UV（如果不是，请使用pip uninstall uv卸载并重新使用brew install uv安装）
• 或者找到UV路径并替换配置中的"command": "uv"为完整路径，例如：$ which 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",