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