Build Agents with Needle MCP Server

基本能力

产品定位

Needle MCP Server 是一个文档管理和搜索服务，旨在通过 Claude 的大型语言模型提供高效的文档检索和管理功能。

核心功能

• 文档管理：轻松添加和组织文档到服务器。
• 搜索与检索：基于 Claude 的自然语言搜索，快速获取答案。
• 易集成：与 Claudie Desktop 和 Needle 集合无缝协作。

适用场景

• 需要高效管理和检索大量文档的场景。
• 通过自然语言搜索快速获取文档信息的场景。
• 与 Claude 和 Needle 生态系统集成的场景。

工具列表

• Claudie Desktop：用于与 Needle MCP Server 交互的桌面应用程序。
• Needle：提供文档管理和搜索功能的生态系统。

常见问题解答

• 安装问题：确保 UV 已全局安装，并且 Needle API 密钥正确。
• 配置问题：检查配置文件路径和 API 密钥是否正确。
• 重置配置：如果遇到旧配置问题，可以删除并重新创建配置文件。

使用教程

使用依赖

1. 安装 UV 全局工具：

brew install uv

1. 获取 Needle API 密钥：从 needle.xyz 获取 API 密钥。

安装教程

1. 克隆仓库：

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

1. 创建配置文件 claude_desktop_config.json：
2. MacOS：~/Library/Application Support/Claude/

3. Windows：%APPDATA%/Claude/

4. 添加配置内容：

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}

1. 替换路径和 API 密钥后，重启 Claude。

调试方式

1. 检查 UV 是否全局安装：

which uv

1. 验证配置文件路径和 API 密钥是否正确。

2. 如果问题依旧，尝试重置 Claude 配置：

rm -rf ~/Library/Application\ Support/Claude/*

1. 重新创建配置文件并重启 Claude。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。