Needle MCP

🚀 使用 Needle MCP 服務器構建代理（Claude 版）

本項目藉助 Needle 的 MCP（模型上下文協議）服務器，實現對文檔的管理，並能使用 Claude 桌面應用程序執行搜索，為用戶提供便捷的文檔檢索與管理體驗。

🚀 快速開始

若你想快速上手使用 Needle MCP 服務器構建代理（Claude 版），可按以下步驟操作：

1. 完成安裝（具體安裝步驟見下方“📦 安裝指南”）。
2. 按照“📚 詳細文檔”中的使用說明進行配置。
3. 開啟 Claude 桌面應用程序，開始使用代理進行文檔搜索與管理。

✨ 主要特性

• 文檔管理：可輕鬆添加和組織服務器上的文檔，便於快速檢索。
• 搜索與檢索：藉助 Claude 的大語言模型，實現基於自然語言的搜索，能快速獲取答案。
• 輕鬆集成：可與 [Claude 桌面](###Claude 桌面中的命令) 和 Needle 集合無縫連接，實現高級文檔管理。

📦 安裝指南

1. 克隆倉庫：

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

2. 使用 Homebrew 在終端中全局安裝 UV：

brew install uv

3. 創建 claude_desktop_config.json 文件：
   • 在 Mac 上：~/.config/claudie/config.json
   • 在 Windows 上：%APPDATA%\Claudie\config.json
4. 將以下內容粘貼到新文件中，並根據需要修改路徑和 API 密鑰：

{
  "proxies": {
    "default_proxy_url": "",
    "needlemcp_api_key": "your_needle_mcp_api_key",
    "mcp_address": "/Users/yourusername/.config/needle-mcp"
  }
}

📚 詳細文檔

使用方法

Claude 桌面中的命令

以下是示例中在 Claude 桌面應用程序中使用命令的截圖：

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

結果在 Needle 中顯示

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

使用說明

1. 打開 Claude 桌面並前往 工具 > 設置。
2. 點擊 代理設置 並選擇 Needle MCP 作為代理提供程序。
3. 在 詳細信息 欄中，填寫以下內容：
   • API 密鑰：your_needle_mcp_api_key
   • MCP 地址：/Users/yourusername/.config/needle-mcp

YouTube 視頻解釋

有關使用 Needle MCP 服務器與 Claude 和 Claude 桌面集成的完整指南，請觀看此 YouTube 解釋視頻。

故障排除

如果在安裝或使用過程中遇到問題，請參考 官方文檔 或聯繫支持團隊。