🚀 使用 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 解释视频。

故障排除

如果在安装或使用过程中遇到问题，请参考 官方文档 或联系支持团队。