🚀 使用针线 MCP 服务器构建代理
本项目是一个使用 Needle 通过 Claude 的桌面应用程序管理文档和执行搜索的 MCP（模型上下文协议）服务器。它可以帮助您组织和存储文档以便快速检索，利用 Claude 的大型语言模型执行强大的搜索，还能平滑地与 Needle 生态系统集成，进行高级文档管理。
🚀 快速开始
您可以按照以下步骤快速开始使用 Needle MCP 服务器：
- 完成服务器的安装（安装方式见下文“📦 安装指南”）。
- 打开 Claude 桌面 并连接到 Needle MCP 服务器。
- 使用简单的文本命令来搜索、检索或修改文档。
- 在用户友好的界面中查看 Claude 返回的搜索结果。
✨ 主要特性
- 文档管理：轻松添加和组织服务器上的文档。
- 搜索与检索：通过 Claude 基于自然语言的搜索快速找到答案。
- 轻松集成：与 Claude 桌面 和 Needle 集合一起使用。
📦 安装指南
通过 Smithery 安装
要通过 Smithery 自动安装 Needle MCP 用于 Claude 桌面，可使用以下命令：
npx -y @smithery/cli install needle-mcp --server-id=your-server-id
手动安装
- 克隆此存储库：
git clone https://github.com/your-username/needle-mcp.git
cd needle-mcp
npm install
重置 Claude 桌面配置
如果看到旧的配置或集成不工作，可按以下步骤操作：
- 找出所有 Claude 桌面配置文件：
find / -name "claude_desktop_config.json" 2>/dev/null
- 删除所有 Claude 桌面数据：
- 在 MacOS 上：
rm -rf ~/Library/Application\ Support/Claude/* - 在 Windows 上：删除
%APPDATA%/Claude/中的内容。
- 创建仅包含 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
-
完全退出 Claude 桌面（Mac 上的 Command+Q）并重新启动它。
-
如果仍然看到旧的配置：
- 检查其他位置是否有额外的配置文件。
- 尝试清除浏览器缓存（如果使用的是网络版本）。
- 验证从正确的位置读取配置文件。
💻 使用示例
基础用法
Claude 桌面中的命令
在 Claude 桌面中使用以下命令与服务器交互的示例：
- 打开 Claude 桌面 并连接到 Needle MCP 服务器。
- 使用简单的文本命令来搜索、检索或修改文档。
- 在用户友好的界面中查看 Claude 返回的搜索结果。
结果在 Needle 中
https://github.com/user-attachments/assets/0235e893-af96-4920-8364-1e86f73b3e6c
📚 详细文档
有关使用 Needle MCP 服务器与 Claude 和 Claude 桌面的全面演练，请观看此 YouTube 解释视频。