返回 MCP 目录
public公开dns本地运行

needle-mcp

Needle MCP服务器是一个文档管理和搜索工具,通过与Claude桌面应用集成,利用Needle生态系统实现高效的文档组织和检索。

article

README

🚀 使用 Needle MCP 服务器构建代理(Claude 版)

本项目借助 Needle 的 MCP(模型上下文协议)服务器,实现对文档的管理,并能使用 Claude 桌面应用程序执行搜索,极大提升文档检索效率。

🚀 快速开始

若想快速上手,可观看此 YouTube 解释视频,它会为你提供使用 Needle MCP 服务器与 Claude 和 Claude 桌面集成的完整指南。

✨ 主要特性

  • 文档管理:可轻松组织和存储文档,以便快速检索,还能无缝集成到 Needle 生态系统,实现高级文档管理。
  • 搜索与检索:利用 Claude 的大语言模型执行强大的基于自然语言的搜索,能快速获取答案。
  • 轻松集成:与 [Claude 桌面](#Claude 桌面中的命令) 和 Needle 集合实现无缝连接。

📦 安装指南

  1. 克隆仓库:
git clone https://github.com/yourusername/needle-mcp.git
  1. 使用 Homebrew 在终端中全局安装 UV:
brew install uv
  1. 创建 claude_desktop_config.json 文件:
    • 在 Mac 上:~/.config/claudie/config.json
    • 在 Windows 上:%APPDATA%\Claudie\config.json
  2. 将以下内容粘贴到新文件中,并根据需要修改路径和 API 密钥:
{
  "proxies": {
    "default_proxy_url": "",
    "needlemcp_api_key": "your_needle_mcp_api_key",
    "mcp_address": "/Users/yourusername/.config/needle-mcp"
  }
}

💻 使用示例

Claude 桌面中的命令

以下是示例中在 Claude 桌面应用程序中使用命令的截图:

在 Claude 桌面中使用命令

  1. 打开 Claude 桌面 并连接到 Needle MCP 服务器。
  2. 使用简单的文本命令搜索、检索或修改文档。
  3. 在用户友好的界面中查看 Claude 返回的搜索结果。

结果在 Needle 中显示

结果展示

使用说明

  1. 打开 Claude 桌面并前往 工具 > 设置
  2. 点击 代理设置 并选择 Needle MCP 作为代理提供程序。
  3. 详细信息 栏中,填写以下内容:
    • API 密钥your_needle_mcp_api_key
    • MCP 地址/Users/yourusername/.config/needle-mcp

📚 详细文档

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端