Needle MCP Server

🚀 使用針線 MCP 服務器構建代理

本項目是一個使用 Needle 通過 Claude 的桌面應用程序管理文檔和執行搜索的 MCP（模型上下文協議）服務器。它可以幫助您組織和存儲文檔以便快速檢索，利用 Claude 的大型語言模型執行強大的搜索，還能平滑地與 Needle 生態系統集成，進行高級文檔管理。

🚀 快速開始

您可以按照以下步驟快速開始使用 Needle MCP 服務器：

1. 完成服務器的安裝（安裝方式見下文“📦 安裝指南”）。
2. 打開 Claude 桌面 並連接到 Needle MCP 服務器。
3. 使用簡單的文本命令來搜索、檢索或修改文檔。
4. 在用戶友好的界面中查看 Claude 返回的搜索結果。

✨ 主要特性

• 文檔管理：輕鬆添加和組織服務器上的文檔。
• 搜索與檢索：通過 Claude 基於自然語言的搜索快速找到答案。
• 輕鬆集成：與 Claude 桌面 和 Needle 集合一起使用。

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Needle MCP 用於 Claude 桌面，可使用以下命令：

npx -y @smithery/cli install needle-mcp --server-id=your-server-id

手動安裝

1. 克隆此存儲庫：

git clone https://github.com/your-username/needle-mcp.git
cd needle-mcp
npm install

重置 Claude 桌面配置

如果看到舊的配置或集成不工作，可按以下步驟操作：

1. 找出所有 Claude 桌面配置文件：

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

2. 刪除所有 Claude 桌面數據：

• 在 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 桌面（Mac 上的 Command+Q）並重新啟動它。

5. 如果仍然看到舊的配置：

• 檢查其他位置是否有額外的配置文件。
• 嘗試清除瀏覽器緩存（如果使用的是網絡版本）。
• 驗證從正確的位置讀取配置文件。

💻 使用示例

基礎用法

Claude 桌面中的命令

在 Claude 桌面中使用以下命令與服務器交互的示例：

1. 打開 Claude 桌面 並連接到 Needle MCP 服務器。
2. 使用簡單的文本命令來搜索、檢索或修改文檔。
3. 在用戶友好的界面中查看 Claude 返回的搜索結果。

結果在 Needle 中

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

📚 詳細文檔

有關使用 Needle MCP 服務器與 Claude 和 Claude 桌面的全面演練，請觀看此 YouTube 解釋視頻。