JANHMS Needle MCP Server

🚀 针对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",
           "/path/to/needle-mcp",
           "run",
           "needle-mcp"
         ],
         "env": {
           "NEEDLE_API_KEY": "your_needle_api_key"
         }
       }
     }
   }
   EOL