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